General Disclaimer 


One or more of the Following Statements may affect this Document 


• This document has been reproduced from the best copy furnished by the 
organizational source. It is being released in the interest of making available as 
much information as possible. 


• This document may contain data, which exceeds the sheet parameters. It was 
furnished in this condition by the organizational source and is the best copy 
available. 


• This document may contain tone-on-tone or color graphs, charts and/or pictures, 
which have been reproduced in black and white. 


• This document is paginated as submitted by the original source. 


• Portions of this document are not fully legible due to the historical nature of some 
of the material. However, it is the best reproduction available from the original 
submission. 


Produced by the NASA Center for Aerospace Information (CASI) 





y6p3/ ' 

JSC-10917 


Revision 1 


CODE USAGE ANALYSIS SYSTEM 
(CUAS) 


Job Order 81-337 


(SASA-CR-151031) CODE USAGE ANALYSIS SYSTEM 
(COAS) (Lockheed Electronics Co.) . 203 p HC 
A10/MF A01 C-*5CL 0 9B 


N77- 10809 


Unclas 

G3/61 08970 


Prepared by 


Lockheed Electronics Company, Inc. 
Aerospace Systems Division 
Houston, Texas 


i to.*®®**® 


Contract NAS 9-12200 




MISSION PLANNING AND ANALYSIS DIVISION 



National Aeronautics and Space Administration 

LYNDON B. JOHNSON SPACE CENTER 


Houston, Texas 


September 1976 


LEC-8119 
Revision 1 




CODE USAGE ANALYSIS CENTER 
(CUAS) 


Job Order 81-337 


PREPARED BY 


P. H. Horsle. 


Support Software SSction 


J. D. Oliver 
lort Software Section 


APPROVED BY 


P. Davisi^ 
Support Sottwi 


upervisor 
■e Section 


Barnes, Manager 
Dynamic Systems Department 


Prepared By 


Lockheed Electronics Company, Inc 


Mission Planning and Analysis Division 


NATIONAL AERONAUTICS AND SPACE ADMINISTRATION 
LYNDON B. JOHNSON SPACE CENTER 
HOUSTON, TEXAS 
September 1976 




tECHSICAL REPORT INDEX/ABSTRACT 

(S ^0 inMtruction^ on rgyeriie girieQ 


I, TITLE AND SUBTITLE OF DOCUMENT 


Code Usage Analysis System (CUAS) 


2> JSC. NO.. 

JSC- 10917, Revision 1 


3. CONTBACTOH/ORBANIZATION NAME 

Lockheed Electronics Company, Inc. 


jA. CON'tBACT on GRANT NO. 

; NAS ,9-1 2200 


5, conthactor/ohiginator document no* 


LEC-8119, Revision 1 


6, PUSlUCAljlDM OjATE [THIS ISSUE} 

September 1976 


7. SECURtTV CLASStFICATION 

Unclassified 


B. OAR (office of PBIMAHV RESPONEt B I L I TV) 


M. A. Goodwin 


9, UMITATIONS 

GOVERNMENT HAS UNUHITED RIGHTS jX | vES f [ i 


IOp AUTHORfSJ 


IF MOj STATE UHITATIONS AnO AUTHORITY 


P* Horsley 
J. D, Oliver 


11, QoCt/MENT CaNTRAor AEFEREKDCS 


t2, HARIWARE QONFlqURATlON 


WORK BHrAK.nOWN STRUCTURE NO, 


5V 1 T1 U 


m 


N/A 


Sun^YATFM 


CONTRACT EXIII BIT NO. 


DRL NO. AND REVISION 


MAJOR EOUIPMENT GROUP 


IpRL LINE ITEM NO. 


13. AO.S TRACT 


The Code Usage Analysis System is a set of computer programs which are designed 
to aid the user in the interpretation of the execution characteristics of his 
application programs. 



JSC Form S33 (Riv Sip 74) KASA-JSC 





















CONTENTS 






Section 

1. INTRODUCTION . 

2. CUAS DESCRIPTION . 

2.1 DEFINITION OF TERMS 

2.2 SYSTEM CAPABILITIES 

2.2.1 EXTERNAL USAGE REPORT 

2.2.2 ERROR LOCATION REPORT ... 

2.2.3 SEGMENT LOADING REPORT ... 

2.2.4 TEST CASE ELEMENT GENERATION REPORT 

2.3 METHOD OF SOLUTION 

2.3.1 EXTERNAL USAGE REPORT 

2.3.2 ERROR LOCATION REPORT 

2.3.3 SEGMENT LOADING REPORT 

2.3.4 TEST CASE ELEMENT GENERATION REPORT 

2.3.5 CUAS COMPONENTS 

3. USER REFERENCE GUIDE 

3.1 METHOD OF USE 

3.1.1 CUAS PREPROCESSOR OPTIONS 

3.1.2 CUAS POSTPROCESSOR OPTIONS 

3.1.3 CUAS TIMING OPTION CONSIDERATIONS 

3.1.4 USER CONTROL OF OVERHEAD 

3.1.5 :UAS OPERATIONAL OPTIONS 

3.2 ERROR MESSAGES 

4. EXECUTION CHARACTERISTICS 

4.1 RESTRICTIONS 

4.2 EXECUTION OVERHEAD 

4.3 ACCURACY/VALIDITY 

4.4 COMPUTER IMPLEMENTATION 

5. REFERENCE INFORMATION 

5.1 FUNCTIONAL FLOWCHART OF CUAS PREPROCESSOR . . . 

5.2 FUNCTIONAL FLOWCHART OF CUAS POSTPROCESSOR . . 

5.3 FUNCTIONAL FLOWCHART OF CUAS CONTINGENCY ROUTINE 

IICONT 




; 


V 


Section Page 

5.4 SYMBOL DEFINITIONS 5-10 

5.5 SUBROUTINE DOCUMENTATION . 5-17 

5.6 SAMPLE RUN STREAM/OUTPUT 5-87 

APPENDIX 

A EXEC 8 STANDARD UNIT OF PROCESSING CHARGES AT 

NASA/ JSC A-1 

B TEST CASE ELEMENT FORMAT B-1 

C UNIVAC EXEC 8 ABSOLUTE ELEMENTS ..... C-1 

D CODE USAGE ANALYSIS SYSTEM JUMP HISTORY STACK FILE D-1 

E TEST CASE USAGE REPORTING SYSTEM E-1 


TABLES 


Table . Page 

5-1 VARIABLES IN LABELED COMMON 5-11 

5-II DATA STATEMENT DEFINED CONSTANTS IN CUAS PREPROCESSOR 

MAIN PROGRAM 5-H 

5-III DATA STATEMENT DEFINED CONSTANTS IN CUAS POSTPROCESSOR 

MAIN PROGRAM - 5-15 


FIGURES 


Figure Page 

2-1 Sample UNIVAC-llOO programming code 2-5 

2-2 Operation of unmodified/modified code 2-8 

2- 3 CUAS technique 2-11 

3- 1 Typical run stream including CUAS 3-2 

B-1 Test case element format B-2 

D-1 Jump history stack file D-6 

E-1 FRED and TCRGEN programs technique E-6 

E-2 FRED program functional flowchart *. E-1 3 

E-3 TCRGEN program functional flowchart ' E-1 8 


CODE USAGE ANALYSIS SYSTEM 
(CUAS) 


' 1. INTRODUCTION 

This document provides information related to the design, operation, and use 
of the Code Usage Analysis System (CUAS). Included in this document are 
descriptions of the systenii capabilities, method of operation, and a user 
reference guide. 

The CUAS is intended to aid the user in developing and performing evaluation 
of application programs. This objective is realized by providing the user 
with reports of subroutine usage, program errors, and segment loading which 
occurred during the execution of an application program. 

The CUAS was evolved specifically to aid in the development and validation of 
the Space Vehicle Dynamics Simulation (SVDS). 


2. CUAS DESCRIPTION 


2.1 DEFINITION OF TERMS 


Contingency 

subroutine 


CPU 

CUAS 

Element 


External 

definition 


Interrupt 


Invalid 

code 


JHS 


LMJ 


A contingency is an'abnomal condition, often associated with 
an interrupt, which may occur during execution of a program. 
EXEC 8 allows a user to register a subroutine to process con- 
tingencies and transfers control to the registered contingency 
subroutine should any abnormal condition occur. 

Central. Processing Unit, a hardware device capable of inter- 
preting instructions and performing the indicated operation 

Code Usage Analysis System 

A named grouping of data, typically manipulated as a unit; as 
used in this document contains a logical program part such as 
a subroutine 

An address within a closed subroutine which may be referenced 
from code which is not a part of the closed subroutine 

A hardware facility that causes a CPU to suspend execution, 
save the machine state, and transfer control to a specific 
address 

Also lOPR (illegal operator); a machine instruction code which 
is not a member of the set of valid machine instruction codes 

Jump Keys, a mnemonic for a valid UNIVAC-1100 processor 
instruction which transfers control to a specific address 

Jump History Stack, a name given to a file of data created by 
the CUAS contingency routine during the execution of an appli- 
cation program 

Load Modifier and Jump, a mnemonic for a valid UNIVAC-1100 
processor instruction which saves the current value of the P 
register and transfers control to a specific address 


A notation for representing execution options in one cell. 

Within the cell, bit 25 is set on if option A was specified and 
bit 0 on if option Z was specified 

Program Control Table 

General purpose constant access time storage directly address- 
able by the CPU and serving generally to contain executing 
programs 

Processor State Register 

General purpose nonconstant access time storage typically avail- 
able to the CPU via a peripheral processor or channel, and 
serving generally to contain nonexecuting programs and data 

Standard Unit of Processing 

Space Vehicle Dynamics Simulation 

Test Case Usage Reporting System 

2,2 SYSTEM CAPABILITIES 

The objective of the CUAS is to apply software technology for questions con- 
cerning software performance and quality which have historically been answered 
by detailed and laborious manual techniques costing considerable time and 
expense. The typical method proposed and implemented for automating program 
performance analysis through software technology involves source code modifi- 
cation, which may become burdensome for the user to apply and impose a con- 
siderable primary storage overhead penalty, making the technique difficult or 
impossible to apply. The technique used in the CUAS does not involve source 
code modification, has a small constant primary storage overhead which for 
most application programs should be negligible, and affords the user more 
infonnation than is possible with a typical source code modification technique. 

Specifically, the CUAS p'^ovides the user the following information concerning 
the execution of his application program. 


Master bit 
notation 

PCT 

Primary 

Storage 

PSR 

Secondary 

storage 

SUP 

SVDS 

TCURS 


2.2.1 EXTERNAL USAGE REPORT 


This report consists of three alphabetically ordered lists: (1) Every user- 

supplied external definition name included in the application program; (2) 
Every user-supplied external definition name referenced as a subroutine during 
program execution and optionally the number of references and execution time; 
and (3) Every user-supplied external definition name not referenced as a 
subroutine during program execution. 

2.2.2 ERROR LOCATION REPORT 

This report locates for the user the element name, relative location within 
the element, and overlay segment name within which a program error (such as a 
floating point overflow) occurred. A walk back which traces the calling 
sequence from the main program element to the element in which the error 
occurred is also provided at the option of the user. 

2.2.3 SEGMENT LOADING REPORT 

This report informs the user how many times each segment of an overlaid pro- 
gram was transferred from secondary storage into primary storage during the 
execution of a segmented and overlaid program. An itemized report of which 
subroutines were called to result in the segment begin loaded is provided for 
each segment loaded at least once. 

2.2.4 TEST CASE ELEMENT GENERATION REPORT 

This report is generated only when specifically requested by the user. When 
requested, the CUAS creates in an EXEC 8 program file a source element con- 
taining the names of those subroutine elements called at least once and those 
not called. The report merely informs the user that the source element has 
been created. The source element created may be used by the Test Case Usage 
Reporting System (TCURS) in producing a cross-reference listing of subroutines 
used and not used within a program file from which several absolute elements 
may be generated. 
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2.3 METHOD OF SOLUTION 
2.3. T EXTERNAL USAGE REPORT 

The external usage reporting technique Involves modification of the machine 
instructions in' an absolute program element after it has been prepared by the 
UNIVAC MAP processor and prior to Its execution. A typical Central Process- 
ing Unit (CPU) of a computer functions in this way: The machine Instructions 
of a program are loaded into sequential contiguous primary storage cells and 
the CPU is given the address of the primary storage cell at which instruction 
execution is to begin. The CPU proceeds from the starting address, executing 
the instructions one at a time in sequence, broken only when the CPU encounters 
a jump- type instruction. 


The jump instruction directs the CPU to execute an instruction at an address 
contained within the jump instruction as the next step rather than the next 
sequential instruction. The CPU will execute the Instruction at the address 
contained in the jump instruction and proceed sequentially until another 
jump instruction is encountered, as Illustrated in figure 2-1, 

The CPU provides the user one other way of changing sequential instruction 
execution flow besides the jump- type instruction, I.e. , the CPU Interrupt. 

The interrupt can change the address of the next instruction to be executed 
by suspending the CPU at any point in its sequential instruction processing. 

Usually, when the interrupt occurs, the address of the next sequential in- 
struction to be executed is saved, and the address of a fixed location in 
primary storage becomes the address of the next instruction to execute. The 
interrupt may be caused by a stimulus external or internal to the CPU. The 
sequential nature of a computer program and the CPU interrupt are both incor- 
porated into the CUAS technique. 


One would realized immediately that in a program containing no jump instruc- 
tions, the CPU executes every Instruction In the program one time only. When 
jump instructions are introduced into the code, it is necessary to know when 
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FORTRAN SOURCE CODE 
I = 1 

CALL SUBACI) 

STOP 

END 

SUBROUTINE SUBACO) 

J = 0 + 1 

RETURN 

END 


UNIVAC 1100 MACHINE CODE CORRESPONDING TO FORTRAN SOURCE CODE 


ADDRESS 

INSTRUCTION 

OPERAND 

COMMENT 

0 

LA,U 

A0,1 

Set AO = 1 

1 

SA 

AO, 6 

Store AO at address 6 

2 

LMO 

Xll,7 

Set Xn=3, jump to address 7 

3 


6 

Parameter address 

■ 4 

+ 

0 

Vacant cell 

5 

ER 

EXIT$ 

Program stop 

6 

+ 

0 

Vacant cell 

7 

LA 

• A0,*0,X11 

Load parameter into AO 

10 

AA,U 

A0,1 

Add 1 to AO 

IT 

SA 

Ao,*o,xn 

Store AO at parameter address 

12 

0 

2,X11 

Jump to address 5 


Figure 2-1.- Sample UNIVAC-ITQO programming code. 


a jump is executed and the address jumped to for determination of a program ' 
execution path. If the execution of each jump~to~subroutine type instruction 
is recorded into a jump history stack, this run statistic may be examined to 
determine the execution frequency of subroutines within a program. If the 
amount of computer time expended in a subroutine is to be determined, the 
execution of each subroutine return type instruction must also be recorded 
into a Jump History Stack (JHS) as well as the amount of time expended between 
the subroutine call and return. 

The CUAS records the fact that Load Modifier and Jump (LMJ) and Jump Keys (J) 
type instructions would have been executed in the following way. 

1. Prior to execution, the instructions of an absolute element are scanned 
for LMJ and J type instructions. Any LMJ instruction which transfers 
control to an address external to the element in which it is contained is 
changed to the invalid code (7700)g, unless control is transferred to a 
FORTRAN library routine. Any J instruction which uses indirect addressing 
or in which the address field of the instruction ts external to the ele- 
ment in which it is contained is changed to the invalid code C7701)g. 

These conventions for instruction modification avoid modifying the majority 
of LMJ or J instructions which are not associated with a subroutine call 

or return. 

2. When the CPU attempts to execute an invalid instruction, it interrupts 
itself and passes control to an interrupt call in EXEC 8. 

3. EXEC 8 executes a user-supplied contingency routine which examines the 
invalid code that the CPU attempted to execute. The instruction type and 
the address to which the original instruction would have transferred con- 
trol are determined and recorded into a JHS on secondary storage. If 
subroutine timing is being performed, the CPU, executive, and I/O (input/ 
output) times that have elapsed since the last invalid instruction trap 
are recorded into the JHS. A software execution of the original instruc- 
tion is performed and program execution continues exactly as if no valid 
instruction contingency had occurred. The execution of a nonmodi fied and 
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a modified LMJ instruction is illustrated in figure 2-2. The technique 
used by the CUAS for determining elapsed computer time is described in 
detail in Appendix A. ■ ^ • 

2.3.2 ERROR LOCATION REPORT 

In the course jf the execution of an application program under EXEC 8, the 
occurrence of any of the following errors will result in a CPU interrupt. 

1. Storage limits violation (Guard Mode) 

2. Floating-point overflow 

3. Floating-point underflow 

4. Divide fault 

Upon the occurrence of the interrupt, EXEC 8 will execute a user-supplied 
contingency subroutine within which the user may take action as he deems 
necessary to overcome the error condition and then either continue or termi- 
nate the program execution. In addition to the above hardware- detected errors, 
two software-detected errors, ERROR MODE and user-requested ABORT, result in 
EXEC 8 executing the user-supplied contingency subroutine. 

The CUAS uses a contingency subroutine to record the type and location of 
the error into the JHS and then continues the program execution from the 
interrupted point for arithmetic- type errors, or terminates the program 
execution for all other type errors. 

2.3.3 SEGMENT LOADING REPORT 

When an application program is segmented and overlaid and segment loading is 
to occur by the indirect method, that is, load on call, a system-supplied sub- 
routine performs the segment loading automatically. In the CUAS, the indirect 
segment loading routine is a part of the contingency subroutine and has the 
expanded capability of recording into the JHS the index of the segment loaded 
as well as loading the segment. The segment loading procedure follows the 
normal method of inspection of the segment load table and actual segment load- 
ing by request to EXEC 8. 

'^^RODUCUiiLL' Y OL-’ ‘ 
tnrrs'AIi F-:'- 


2-7 


FORTRAN SOURCE CODE 
CALL SUBA(A.B) 


UNMODIFIED MACHINE CODE 


LMJ 


Xll.SUBA 


+ A 

+ B 

+ Walk Back 


t 


CONTROL TRANSFERRED 
TO ADDRESS OF 
SUBA 

) 

SUBA* NOP ® 


r 

MODIFIED MACHINE CODE 

lOPR X11,SUBA- — j 

+ A 

+ B 

+ Walk Back >,• 

EXEC 8 TRAPS lOPR 

* INTERRUPT, TRANSFERS 

CONTROL TO CONTINGENCY 

ROUTINE, JUMP RECORDED 
CONTROL TRANSFERRED TO 

* ADDRESS OF SUBA 

SUBA* NOP ^ 


Figure 2-2.- Operation of unmodifi ed/modified code. 



2.3.4 TEST CASE ELEMENT GENERATION REPORT ’ 


The external usage report generates the data for a source element of those 
subroutines called and not called, and the UNIVAC program rile element main- 
tenance package SOR is utilized to create the element. The element created 
may be manipulated with the UNIVAC FURPUR commands exactly as any other 
UNIVAC SDF source element. The format of the element is covered in detail in 
Appendix B. 

2.3.5 CUAS COMPONENTS 

The CUAS consists of a preprocessor, a contingency subroutine, and a postproc- 
essor. The first step in the application of the system is for the user to 
collect his program, including the CUAS contingency subroutine. The first 
executable statement of every FORTRAN program under EXEC 8 is a subroutine 
call to the external reference NINTR$. The FORTRAN library contains a stand- 
ard contingency subroutine named NINTR$ which will satisfy this external 
reference. The CUAS contingency subroutine also will satisfy the external 
reference NINTR$ and so will override the library-supplied routine. 

The absolute element thus obtained will execute and operate identically the 
same as if the library-supplied NINTR$ subroutine had been included in the 
program. The CUAS preprocessor is used to prepare the absolute element such 
that the JHS will be created during the program execution. The CUAS pre- 
processor scans the code of each user-supplied subroutine in the absolute 
element and changes the operation field of LMJ and J type instructions to an 
invalid code, as required to generate the report detail requested by the user 
through execution options. The preprocessor uses the diagnostic tables from 
the absolute element {which are shown in detail in Appendix C) to locate the 
I-BANK code for each user-supplied subroutine within the absolute element. 

The preprocessor sets a sentinel cell within the contingency routine so that 
this routine may determine that the code has been modified and the JHS is to 
be created. 


When the absolute element thus prepared by the preprocessor Is executed, the 
jump history file will be created. The creation of this file is completely 
transparent to the user, and his program will apparently operate identically 
as if the code had not been modified. 

Once the execution of the user's program is complete, the CUAS postprocessor 
is executed to prepare the reports of the execution from the JHS. The post- 
processor also uses the diagnostic tables from the absolute element to corre- 
late the addresses contained in the jump history stack file to user- recognizable 
element, segment, and external reference names. 

The total operation of the CUAS is depicted in figure 2-3, and the content 
and format of the jump history stack file is described in Appendix D. The 
Test Case Usage Reporting System is described in Appendix E. 
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Figure 2-3.- CUAS technique 






3. USER REFERENCE GUIDE 


3.1 METHOD OF USE 

The CUAS has been implemented on the UNI VAC 1110 Series, EXEC 8 operating system 
and may be accessed from the secure file FML-L79351*PHPA. , hereafter referred 
to as file X. In order for a JHS to be created when a program is executed, 
the collection of the absolute program element must include the element IICONT 
from file X. This is easily achieved by copying the element IICONT into the 
file TPF$ just prior to collection of the absolute element. Once the absolute 
element is collected, the CUAS preprocessor element CUAPREPRO must be executed 
to prepare the absolute element to create the jump history stack. The CUAS 
preprocessor automatically prepares the last absolute element inserted into 
the file TPF$. The absolute element thus prepared may now be executed in the 
normal manner, and during its execution a file named JHS will be produced 
containing the jump history stack for the program. Once the execution is 
complete, the CUAS postprocessor element CUAPSTPRO must be executed to pro- 
duce the code usage reports. The CUAS postprocessor automatically reads the 
file named JHS and compares it with data tables from the last absolute element 
inserted into the file TPF$. For proper execution, the absolute element pro- 
ducing the file named JHS must be the last absolute element inserted into the 
file TPF$ at the time the postprocessor is executed. A typical run stream 
including the utilization of the CUAS is depicted in figure 3-1. 

3.1.1 CUAS PREPROCESSOR OPTIONS 

When the preprocessor is executed with no option, the postprocessor external 
usage report will contain the names of those subroutines called and the total 
number of calls to each. If the user wishes the execution time of each sub- 
routine in addition to the calling frequency, the option C must be inserted 
on tiie preprocessor execute statement in the following way. 

0XQT,C X. CUAPREPRO 
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RUN STREAM 



1 . 

0RUN 



2. 

0USE X, 

,FML-L79351*PHPA. 


3. 

0COPY," 

X.IICONT,TPF$. ^ ‘ 


4. 

@MAP,S 

USERFILE.USERMAP, ABSELT 


5. 

0XQT 

X.CUAPREPRO 

1 

6. 

0XQT 

ABSELT 


7. 

@XQT 

X.CUAPSTPRO 

1 

t 

i 

8. 

0FIN 


\ 



RUN STREAM DESCRIPTION 


1. 

Required statement to initiate run on EXEC 8. | 

1 

2. 

Assign reference name X to the CUAS file. 


3. Copy the element IICONT into the run's TPF$ file. 

4. Collection of absolute in normal way and saved in run's TPF$ file. 

5. The CUAS preprocessor is executed to prepare the absolute element ABSELT 
for producing a JHS. 

6. The absolute element ABSELT executed in the normal way. 

7. The CUAS postprocessor is executed to produce its reports once the 
execution of ABSELT is complete. 

8. Required statement to end run on EXEC 8. 


Figure 3-1,- Typical run stream including CUAS. 
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Use of this option gives the user the maximum reporting capability of the CUAS 
and also requires the greatest amount of execution time overhead. The times 
reported will not include CUAS execution overhead, and will reflect the time 
required to execute the subroutines in a normal untraced execution. 

If the user is interested in determining only if an external definition has 
been referenced or not during execution, run time overhead may be reduced by 
inserting the option A on the preprocessor execute statement in the following 
way. 


0XQT,A X.CUAPREPRO 

When the user's absolute element is then executed, only the first occurrence 
of an LMJ to an external definition will be trapped and all successive occur- 
rences will operate normally. This option trades off less reporting capability 
for less execution time overhead and a small jump history stack file. When 
this option is used, the postprocessor will report only if an external name 
was referenced or not, and no error walk backs will be produced in the error 
location report. The error location report will still be available but will 
be limited to the location of the element and segment in which each unique 
error occurred. 

If the user is not interested in any external usage report and desires only 
error location and/or segment loading reports, run time overhead may be further 
reduced by inserting option B on the preprocessor execute statement in the 
following way. 

@XQT,B X.CUAPREPRO 

When the user's absolute element is then executed, LMJ instructions will be 
processed in the normal manner and only error conditions and segment loads 
will be trapped. When this option is used, the postprocessor will produce no 
external usage report and no error walk backs will be produced in the error 
location report. 
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3.1.2 CUAS POSTPROCESSOR OPTIONS 

The CUAS postprocessor options afford the user the capability to limit the 
reports produced by the postprocessor to those he desires. The user may 
choose none or one or more of the following options to be included on the 
execute card for the postprocessor. 

Meaning 

Do not produce the external usage report. 

Do not produce the error location report. 

Do not produce the segment loading report. 

Include a walk back for each error located 
in the error location report. Walk backs 
are not possible if either option A or B 
was specified on the CUAS preprocessor 
execution. 

G Generate a source element for the TCURS, 

and report the generation of this element. 
Generation of this element will not be 
possible if option B was specified on the 
CUAS preprocessor. When this option is 
used, following the postprocessor execution 
card must be one additional card on which 
is specified in columns 1-8 the name for 
the element to be created. The element is 
created in a program file with the internal 
file name DBF which the CUAS postprocessor 
will automatically assign and free so that 
the user need only equate the name DBF to 
his secure file name with an EXEC 8 @USE 
directive. Options X and G must not be 
used together, since the external usage 


Option 

X 

E 

S 

W 
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Option 


1 


Meaning 

report must be generated if the test case 
element is to be created. The CUAS post- 
processor will always include the version 
name TESTCASE on every test case element 
it generates in the file DBF. 

blank When no option is specified, all possible 

reporzs will be generated, with the excep- 
tion of the test case element generation 
report. 

As an example, the following postprocessor execution would generate a test 
case source element and would not produce the segment loading report. 

@XQT,6S X.CUAPSTPRO 

3.1.3 CUAS TIMING OPTION CONSIDERATIONS 

When the option C is specified to the CUAS preprocessor, a report of charge 
time by subroutine will be generated. The CUAS does not trace calls to 
elements from the UNIVAC SYS$*RLIB$ library file or to any element which 
includes one or more $ characters in its name. The time spent within these 
elements is accrued to the user-supplied element from which they were called. 
The charges reported in this manner accurately reflect the time necessary to 
execute the users -supplied FORTRAN source code, but do not provide a break- 
down of charges for the execution of UNIVAC-supplied support subroutines. 

The timing of UNIVAC-supplied support routines would probably be only of 
academic interest to the application programmer since typically it is not 
within the scope of his job or interest to revise or modify such software. 

Such software may be indirectly evaluated by the CUAS by creating a FORTRAN 
source element that only references a library support software function, such 
as the FORTRAN WRITE statement. The time charged to such a routine would then 
be a charge evaluation of those routines which support the WRITE statement. 


3-5 


The CUAS should not be used to evaluate a long-running iterative subroutine 
calling sequence program unless an execution test case is chosen which in- 
vokes only one or two loops through the calling sequence. Test cases which 
invoke several loops will not enhance the timing data but will cost the user 
a considerable amount of computer time for timing overhead. 

3.1.4 USER CONTROL OF OVERHEAD 

The file JHS in which the execution statistics of a program are stored is 
automatically created by the CUAS contingency routine IICONT. This file has 
a default maximum size of 10*000 tracks which are allocated in increments of 
100 tracks as needed, with each track containing 1792 36-bit cells of 
data. In general, the user should estimate for each track of data stored by 
subroutine IICONT an additional 1-second SUP charge above and beyond the 
normal running time for his program when not being analyzed by the CUAS. The 
CUAS postprocessor requires approximately a 1 -second SUP charge for processing 
each track of data produced by subroutine IICONT, so that the approximate 
total overhead per track is 2 SUP seconds. The above overhead estimates are 
for the maximum overhead case, which is the subroutine timing report genera- 
tion capability of the CUAS; when other reporting options are chosen, the 
overhead per track will be somewhat less. 

The user may limit the number of tracks of data created and processed by the 
CUAS by overriding the default maximum size of the file JHS. This is done by 
assigning the file JHS with an EXEC 8 assign statement prior to the execution 
of the user's program which is to be traced. An assignment statement which 
limits the maximum JHS file size to 50 tracks might be prepared in the fol- 
lowing way. 

@AS6,T JHS.,F4/50//50 

When the maximum size of the file JHS has been reached, subroutine IICONT 
discontinues all tracing and the application program continues its processing 
from that point in the normal way. When the JHS file is filled and closed 
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prior to the end of program execution, the CUAS postprocessor will so tnform 
the user in its report, and the G option will be disabled. The production 
of an element containing the names of subroutines used and not used may not 
correct when program tracing is discontinued prior to program completion. 

3.1,5 CUAS OPERATIONAL OPTIONS 

If the file named JHS and the absolute element creating the file are both 
saved, the CUAS postprocessor may be executed in a job run some time after 
the one in which the file JHS was created. Multiple executions of the post- 
processor may also be done in the same job or a later job. The following 
two requirements are necessary and sufficient for the execution of the CUAS 
postprocessor. 

1. The ab'^olute element which created the file JHS is present in the file 
TPF$ and is the last absolute element inserted into the file TPF$. 

2. The jump history stack file is attached to the job, has the internal 
file name JHS, and contains a jump history stack for the execution of 
the identical absolute element in the file TPF$. 

If both of the above conditions are not met, the postprocessor will provide a 
diagnostic message informing the user of the problem and terminate without 
producing any reports. 

If the CUAS contingency subroutine IICONT has been included in an absolute 
element but the CUAS preprocessor is not executed prior to the execution of 
that absolute element, no jump history stack file will be created, no execu- 
tion time overhead will be incurred, and the element will operate identically 
as if the standard FORTRAN contingency routine were present. Once an absolute 
element has been modified by the CUAS preprocessor, each successive execution 
of that absolute will produce a new jump history stack file without further 
execution of the CUAS preprocessor. Once an absolute element has been created 
which includes the CUAS contingency subroutine IICONT, any sp.cific execution 
of that absolute may be analyzed by copying it into the file TPF$ and execu- 
ting the CUAS preprocessor just prior to the execution of the absolute. 
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3.2 ERROR MESSAGES 

When the CUAS detects an error or option conflict condition, a message is 
generated which fully describes the condition, giving enough Information to 
allow the user to take remedial action. The CUAS utilizes dynamic core 
expansion and may be executed from an EXEC 8 demand terminal. The CUAS will 
not expand core above 20K when it is executed as a demand job, and an error 
message Is provided. Both the pre- and postprocessor require approximately 
lOK static core, leaving. lOK for data area expansion. 
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4. EXECUTION CHARACTERISTICS 


4.1 RESTRICTIONS 

The CUAS Is implemented for operation with FORTRAN. programs including any 
UNI VAC 1100 ASSEMBLER programs which conform to FORTRAN conventions. The con- 
cept of the CUAS should be applicable to any EXEC 8 single activity application 
program in which code and data have been separated so that each may be recog- 
nized, i.e., I-BANKs and D-BANKs. The CUAS, as implemented, assumes that all 
the code for a user-supplied subroutine may be found in the absolute element 
I-BANK. The CUAS will not operate properly with programs v/hich involve multi- 
activites, reentrant code, multi banking, or common banks, and intermixed code 
and data in the program’s I-BANK. 

The above restrictions were designed into the CUAS after identifying the 
potential users of the CUAS as FORTRAN application programs. The restrictions 
seemed reasonable in view of the fact that the CUAS will perform its intended 
purpose within the environment of FORTRAN application programs and globally 
expanding the capability of the CUAS would significantly increase the execution 
and primary storage overhead associated with the technique. 

4.2 EXECUTION OVERHEAD 

The execution overhead of the CUAS involves additional primary storage for the 
contingency subroutine above that which would be used for the standard con- 
tingency subroutine NINTR$, and additional execution time to perform software 
executions of an LMJ instruction. The primary storage overhead is always a 
fixed constant, approximately SOO storage cells above the version of NINTR$ 
which would have otherwise been used by the application program. The user 
may arrive at an exact figure by comparing the length of the NINTR$ version 
which he would normally use with the CUAS version of NINTR$. The execution 
time overhead has been found to be approximately 1 millisecond total Standard 
Unit of Processing (SUP) additional charge for each contingency interrupt 
trapped. A SUP is used on UN I VAC EXEC 8 systems for determining computer 
use charges and is comprised of CPU time, I/O time, and executive time. The 
1 millisecond figure was arrived at by comparing execution SUP charges for the 


execution of a program without the CUAS applied and the identical execution 
of that program with the CUAS applied. Additional SUP charges accrued when 
the CUAS was applied were divided by the number of contingency interrupts to 
arrive at an average charge per interrupt. This technique was applied to 
several application programs to project an overall average expected execution 
time overhead. 

When the CUAS timing report is invoked by option C on the preprocessor execu- 
tion card, a very large JHS file will very likely be created. The size is 
dependent on the number of subroutine calls and returns trapped. The size of 
the JHS will be an order of seven times larger than it is when only subroutine 
frequency is requested by no option on the preprocessor execution card. The 
amount of data captured in a timing analysis will require a considerable amount 
of executive and I/O time and typically the user should expect an increase 
of three to four times in the total charges to execute the program. An abso- 
lute value cannot be placed on the increase since it is dependent entirely on 
the number of subroutine calls in the program being' traced. In general, the 
CUAS should not be used to time long-running iterative calling loop programs 
unless the execution test case invokes only one or two loops through the pro- 
gram. Such analysis will supply the user with the cost data for each sub- 
routine and will not involve a large overhead. 

4.3 ACCURACY/VALIDITY 

The CUAS was verified by applying it in the analysis of application programs 
whose execution characteristics were known. The results of the CUAS reports 
for such programs were desk checked to ensure that they reflected accurately 
what was known to have happened during the execution of the program. 

4.4 COMPUTER IMPLEMENTATION, 

The CUAS is designed and programmed to operate only on UNIVAC 1100 series 
computers which are operated with the UNIVAC EXEC 8 operation system. As of 
this writing, the CUAS is compatible with UNIVAC EXEC 8 level 31.244, update 
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level D, UNIVAC FORTRAN V level E3 and UNIVAC MAP level 27.1. The entire 
CUAS is coded in the FORTRAN and ASSEMBLER languages with approximately 95 
percent of the code in FORTRAN. The reference version of the CUAS was imple 
men ted at the NASA/ JSC computing center in June 1976. 
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5.4 SYMBOL DEFINITIONS 


Table 5-1 describes all variables used in labeled COMMON blocks within the 
CUAS preprocessor and postprocessor. BLANK COMMON is not used in either 
program, and the CUAS contingency' routine IICONT uses no COMMON, 

Table 5-II describes constants defined by DATA statements in the CUAS preproc- 
essor main program (CUAPREPRO). 

Table 5-III describes constants defined by DATA statements in the CUAS post- 
processor main program (CUAPSTPRO). 







TABLE 5-1.- VARIABLES IN LABELED COMMON 


0 COMMON BLOCK NAME: ACWCNT 

DESCRIPTION: ACWCNT is used for the convnum' cation of code access channel 
words from the subroutine FCODE to the subroutine calling FCODE. ACWCNT is 
used only in the CUAS preprocessor. 


LOCATION 

name 

DIMENSION 

TYPE 

DESCRIPTION 

1-8 

KACW 

8 

I 

Cells 1 and 2 contain the base 


offset and length of the access 
channel words. Cells 3-8 are 
used to contain up to two chan- 
nel word directives. This array 
is dynamically expanded in more 
locations as needed. 

1 COMMON BLOCK NAME: CONTRL 

DESCRIPTION: CONTRL is used to retain general control information for the 

operation of the CUAS postprocessor. CONTRL is used only in the CUAS post- 


processor. 





LOCATION 

NAME 

DIMENSION 

TYPE 

DESCRIPTION 

1 

IPSTOP 

1 

I 

The 0XQT options, in master bit 
notation, from the postprocessor 
execution 

2 

IPREOP 

1 

I 

The @XQT options, in master bit 
notation, from the preprocessor 
executi on 

3 

IFWJHS 

1 

I 

The number of the cell in the 
jump history stack file where 
the first even cell is located 
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• COMMON BLOCK NAME: JHSCNT 

DESCRIPTION: JHSCNT contains information relating to the reading of the Code 

Usage Analysis 'System (CUAS) Jump History Stack File (JHSF). JHSCNT is used 


only in the CUAS postprocessor. 



LOCATION 

NAME 

DIMENSION 

TYPE, 

DESCRIPTION 

1 

JHS 

1 

I 

The six-character fi el data in- 
ternal file name used to refer- 
ence the JHSF 

2 

NSIJHS 

1 

I 

The length of the JHSF in 28- 
cell sectors 

3 

IBIHN 

1 

I 

The number, relative 0, of the 
11 2-cell block of the JHSF now 
contained in the I/O buffer 
array IBUF 

4 

LBIMN 

1 

I 

The length, in cells, of the 
block of the JHSF now contained 
in the I/O buffer array IBUF 

5-116 

IBUF 

112 

I 

An I/O buffer array for contain- 
ing four contiguous sectors of 
the JHSF 
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• COMMON BLOCK NAME: TABLES 


DESCRIPTION: TABLES is used to retain the location and length of the diag* 
hostic tables from an absolute element, and is used in both the CUAS pre- 
processor and postprocessor. Primary storage for the diagnostic tables is 
dynamically allocated, and TABLES does not contain any of the data, but only 
pointers to the table locations in core and the length of the tables. 


LOCATION 

NAME 

DIMENSION 

TYPE 

DESCRIPTION 

1 

lUN 

1 

I 

The name of the file which con- 
tains absolute element diagnosti 
tables 

2-n 

lADE 

10 

I 

The program file directory 
entry for the absolute element 

12-39 

lAHD 

28 

I 

The first sector of the abso- 
lute element text 

40-41 

MSNT 

2 

I 

The base offset and length of 
the segment name table 

42-43 

MENT 

2 

I 

The base offset and length of 
the element name table 

44-45 

MBNT 

2 

I 

The base offset and length of 
the bank name table 

46-47 

MSET 

2 

I 

The base offset and length of 
the location counter table 

48-49 

MEPT 

2 

I 

The base offset and length of 
the entry point table 

50-51 

MSLT 

2 

I 

The base offset and length of 
the segment load table 


TABLE 5- I I.- DATA STATEMENT CONSTANTS IN CUAS PREPROCESSOR MAIN PROGRAM 


PARAMETER 

NAME 

lOPTA 

lOPTB 

lOPTC 

LTRA 

LTRB 

LTRC 

NINTR 

LMASK 

lUN 

MSENT 


VALUE 

C00020000000)g 


(0001 0000000) g 

(000040000000 )g 


• fi • 


*B' 

•c 

*NINTR$' 
(000000777777) 


8 


DESCRIPTION 

A bit mask used to extract the option 
A bit position from an option cell in 
master bit notation 

A bit mask used to extract the option 
B bit position from an option cell in 
master bit notation 

A bit mask used to extract the option 
C bit position from an option cell in 
master bit notation 

The alpha letter A ■ 

The alpha letter B 

The alpha letter C 

The alpha letters NINTR$ 

A bit mask used to extract the lower 
18 bits of a cell 


■TPF$' The alpha letters *TPF$‘ 

( 666666666666) g A sentinel used for insertion into the 

contingency subroutine IICONT 


PARAMETER 

NAME 

JHSASG 

IFRMSK 

LTRSO ) 
LTRS(2) 
LTRS{3) 
LTRS(4) 
lOPTW 

lOPTG 

IGOFF 

lOPTX 

lOPTE 


TABLE 5- II I.- DATA STATEMENT DEFINED CONSTANTS IN 
CUAS POSTPROCESSOR MAIN PROGRAM 


VALUE 

(00411 2302700)g 

I 

•NO' 

■c 

'B' 

•A' 

(00000000001 0)o 

o 

(000002000000 )g 

(777775777777)g 

(000000000004)g 

(00001 0000000)g 


DESCRIPTION 

An array contafning the character 
string '@ASG,A JHS.' 

A bit mask for checking a facility 
status cell 

The alpha letters NO 

The alpha letter C 

The alpha letter B 

The alpha letter A 

A bit mask used to extract the option 
W bit position from an option cell in 
master bit notation 

A fait mask used to extract the option 
6 bit position from an option cell in 
master bit notation 

A bit mask used to clear the option G 
bit position from an option cell in 
master bit notation 

A bit mask used to extract the option 
X bit position from an option cell in 
master bit notation 

A bit mask used to extract the option 
E bit position from an option cell in 
master bit notation 
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PARAMETER 

NAME 

VALUE 

DESCRIPTION 

lOPTS 

(000000000200)g 

A bit mask used to extract the option 
S bit position from an option cell in 
master bit notation 

lOPTB 

(OOOlOOOOOOOO)g 

A bit mask used to extract the option 
B bit position from an option cell in 
master bit notation 

IFWSJHS 

8 

The integer value 8 

I UN 

'TPF$' 

The alpha letters TPF$ 

JHS 

'JHS' 

The alpha letters JHS 

NSIJHS 

0 

The integer value 0 


pKPROBUcrBiLrrY of the 
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5.5 SUBROUTINE DOCUMENTATION 

Individual documentation of the non-UNIVAC EXEC 8 supplied subroutines used 
the CUAS appears in alphabetical order on the following pages. 






I- 
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SUBROUTINE BD2FD 


IDENTIFICATION 

Name (Title) - BD2FD (Binary Data to Fi el data) 

Programmer, Date - P. H. Horsley, March 1976 

Machine Identification - UNIVAC 1100 - Series 
Source Language - FORTRAN V 

PURPOSE 

Subroutine BD2FD converts the data and time entry from an EXEC 8 program file 
directory item to a four-cell string of fi el data characters. 

USAGE 


e Calling Sequence 

CALL 5B2FD(IBDAT, IFDDAT) 
Arguments : 


Parameter 



name 

In/Out 

Dimension 

I BOAT 

In 

1 

IFDDAT 

Out 

4 


Type Description 

I Time in seconds past mid- 

night in bits 18-35, 
month in bits 12-17, day in 
bits 6-11, year M0D(64) in 
bits 0-5 

I Four-cell array containing 

'MM/DD/YYbbbb HH:MM:SSbbbb* 
where MM=month, DD=day, 
YY=year, HH=hour, MM=minutes, 
SS=seconds, b=fieldata blank 


llMSilDING PAGE BLANK NOT Fi 


METHOD 


• Model 

i The binary values of the date and time are separated from the input param- 

eter I BOAT, and a fi el data character string of the corresponding numbers 
j is constructed in the output parameter array IFDDAT. 

i 

^ RESTRICTIONS 

1 • Operational 

i f 

! 

1 Subroutines ICLSFT and ILLSFT are required. 

I 

i 


i 

i 
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SUBROUTINE BUBSRT 



IDENTIFICATION 

Name (Title) - BUBSRT (Bubble Sort) 

Programmer, Date - P. H. Horsley, September 1975 

Machine Identification - UNIVAC 1100 - Series 

Source Language - FORTRAN V 

PURPOSE 

Subroutine BUBSRT sorts a numeric Integer array into ascending sequence and 
optionally reorders two other arrays in the same sequence as the sorted array. 


USAGE 

• Cal 1 i ng Sequence 

CALL BUBSRT (lA, IP. NC, L, N) 
Arguments: 

s 

? 

Parameter 


name 

In/Out 

Dimension 

Type 

Description 

lA 

In 

Variable 

I 

The integer array to sort 

IP 

In 

Variable 

I 

The first array to be reordered same 
as lA. See parameter N 

NC 

In 

Variable 

I 

The second array to be reordered same 
as lA. See parameter N 

L 

In 

1 

I 

The length of the array lA. If IP and/ 
or NC are used, then their lengths are 
assumed the same as lA 

N 

In 

1 

I 

If 1, do not reorder IP or NC 

If 2, reorder IP only 

If 3, retrder both IP and NC 

lA 

Out 

Variable 

I 

The sorted array 

IP 

Cut 

Variable 

I 

Reordered array 

NC 

Out 

Variable 

I 

Reordered array 
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METHOD 


• Model 

Subroutine BUBSRT uses a bubble sort technique to reorder the integer array 
lA into ascending sequence numerically. The arrays IP and NC are not sorted 
but strictly reordered in the same sequence as the array lA. For example, 
if the sort of the array lA requires swapping the values in position i 
and j, the values in position i and j of the arrays IP and NC are also 
swapped. If the reordering of either IP, NC,' or both is not desired, these 
arguments in the calling sequence need not be arrays but may be merely 
undimensioned dummy arguments. 


SUBROUTIME CKDOLR 


IDENTIFICATION 

Name (Title) - CKDOLR (Check Dollar) 

Programmer, Date - P. H. Horsley, April 1976 

Machine Identification - UN I VAC 1100 - Series 
Source Language - FORTRAN V 

PURPOSE 

Subro' tine CKDOLR determines if a fieldata $ character is included in a two- 
cell array of fieldata characters. 

USAGE 

0 Calling Sequence 

CALL CKDOLR (NAME, I RET) 

Arguments : 


Parameter 

name 

In/Out 

Dimension 

Type 

Description 

NAME 

In 

2 

I 

The array of fieldata 
characters to check for a 
$ character 

IRET 

Out 

1 

I 

0 if no $ character found 
if 1, array contains at 
least one $ character 

METHOD 





» Model 






The two-cell array of characters is inspected from left to right, with the 
scan terminating either when a $ character is found or when all characters 
have been inspected. 


RES.RICTIONS 
• Operational 

Subroutine IRRSFT is required 


SUBROUTINE CLSEOR 


IDENTIFICATION 

Name (Title) 
Programmer, Date 
Author, Date 
Machine Identification 
Source Language 


- CLSEOR (Close Output Routine) 

- D. M. Braley. May* 197^3 ' 

- P. H. Horsley, June 1976 

- UNIVAC 1100-Series 

- UNIVAC 1100-Series Assembler 


PURPOSE 


Subroutine CLSEOR closes- a symbolic element in an EXEC 8 program file which 
was opened with subroutine OPNEOR. 


USAGE 

9 Calling Sequence 
CALL CLSEOR ($LAB) 
Arguments : 


Parameter 

name 

In/Out 

Dimension 

Type 

Description 

$LAB 

- 

- 


The label number to return 
to if element is not suc- 
cessfully closed 

METHOD 





9 Model 






The UNIVAC-supplied package SOR is used to close the source element. SOR 
is documented in U.P. 4144, Rev, 3. 


RTOODUOIBILiry OF 

original page is P0(^ 
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RESTRICTIONS 


• Operational 

Subroutine OPNEOR must be called to open the source element, and usually 
subroutine OUTIMG will be called to insert source lines Into the element 
before subroutine CLSEOR is called to close the elouent. 


1 



SUBROUTINE CSFER 


IDENTIFICATION 

NAME (Title) 
Programmer, Date 
Machine Identification 
Source Language 


- CSFER (CSF EXEC Request) 

- P. H. Horsley, May 1976 

- UN I VAC 1100 -Series 

- UNIVAC 1100-Series Assembler 


PURPOSE 

Subroutine CSFER performs an executive request to the EXEC 8 entry point CSF$. 



USAGE 

0 Calling Sequence 

CALL CSFER (ICC, ISTAT) 

Arguments : 

Parameter 

name In/Out Dimension 

ICC In Variable 


ISTAT Out 1 

METHOD 
0 Model 


Type Descrl ption 

I Array containing control 

card image for CSF$ formatted 
I as described in U.P. 4144, 
Rev. 3, pp. 4-41 , 43 

I 

I Status from register AO 

following completion of 
request 


Subroutine CSFER does an executive request to the EXEC 8 entry point CSF$. 
The address of the parameter array ICC is supplied as the control card 
image address, and the content of the register AO is stored in parameter 
ISTAT upon return from the request. 
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SUBROUTINE DISKIO 


IDENTIFICATION 

Name (Title) - DISKIO (Disk Input Output) 

Programmer, Date - P, H, Horsley, September 1975 

Machine Identification - UNI VAC 1100 - Series 
Source Language - UNIVAC 1100 - Series Assembler 


PURPOSE 


Subroutine DISKIO will either read or write FASTRAND formatted secondary 
storage on UNIVAC 1100 EXEC 8 operating systems. 


USAGE i 

• Calling Sequence 

CALL DISKIO (lUN, lOP, ISS, INS, MRAY, ISTAT,) , 
Arguments : 

Parameter 


name 

In/Out 

Dimension 

Type 

Description 

lUN 

In 

1 

I 

A six-character fi el data name of the 
file name to read/write. The name is 
expanded to 12 characters by subrou- 
tine DISKIO by adding six blanks. 

lOP 

In 

1 

I 

A 1 for write operation or 2 for read 
operation. 

ISS 

In 

1 

I 

The sector number relative to 0 at 
which to start the read or write 

INS 

In 

1 

I 

The number of 28 cell sectors to read/ 
write starting at sector ISS 

MRAY 

In/Out 

28* I NS 

I 

If lOP = 1 , the primary storage array 


is transferred to secondary storage. 

If lOP = 2, the primary storage array 
is filled from secondary storage. The 
length of this array must be defined 


r?vECi®iNG page blank not 
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Parameter 

fianie In/Out Dimension • Type 


Description 


by the caller and must be adequate to 
contain the number of 28 cell sectors 
to be transferred. 

ISTAT Out 1 I The postive actual number of cells 

transferred if the operation completes 
normally, a negative number, same as 
I/O error messages from UNIVAC Publica- 
tion 4144, Rev,. 3, Appendix C, if the 
I/O was not completed normally. A 
positive number returned but less than 
28*INS indicates end of allocated mass 
storage was reached during the transfer 
and only the indicated number of cells 
was transferred. 


0 Error Messages 

None - errors indicated only by value of the parameter ISTAT upon return to 
caller. ISTAT will be set to -100 if the value of the parameter lOPis 
neither 1 or 2. 


METHOD 
• Model • 

Subroutine DISKIO creates an I/O packet for the read or write request and 
then performs the actual I/O operation with an Executive Request (ER) to 
the EXEC 8 entry point I0W$. The variable ISTAT is set directly from the 
I/O packet status cell before returning to the caller. 


j Subroutine DISKIO saves and restores all registers used interpally. 

i 

I 

i e Reference 

I UNIVAC Publication 4144, Revision 3, Section 6.3.5, pages 6-11 and 

! Appendix C. 

I 

i 

1 


! 
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SUBROUTINE ELRPT 


IDENTIFICATION 


Name (Title) 


- ELRPT (Error Location Report) 


Programmer, Date 


- P. H. Horsley, December 1975 


Machine Identification - UNIVAC 1100 - Series 


Source Language 


- FORTRAN V 


PURPOSE 


Subroutine ELRPT produces the CUAS error location report and is intended for 
use only within the CUAS postprocessor. 


USAGE 


• Calling Sequence 

CALL ELRPT (lERR, ISTAT) 
Arguments : 


Parameter 

name In/Out Dimension Type 


Description 


An error indicator, set nonzero to 
indicate an error and type 


ISTAT 


A status flag associated with the 
error type 


« Labeled COMMON 

All of the labeled COMMON blocks TABLES and CONTRL are required (refer to 
labeled COMMON block description in table 5-1. The data in both COMMON 
blocks are used strictly as reference data and no output from the subrou- 
tine occurs through the COMMON blocks. 


• Error Messages 

None - all errors are indicated by a nonzero value of the parameter lERR. 
lERRs'SOl indicates an I/O error has occurred while attempting to read file 




OHS, and IERR=902 indicates that the required dynamic core could not be 
allocated. In the second case, parameter ISTAT contains the amount of core 
needed. 

METHOD 
9 Model 

Subroutine ELRPT scans the CUAS OHS to locate error event cells entered in 
the file by the CUAS contingency routine IICONT. The content and format 
of the OHS is presented in Appendix D of the CUAS program documentation. 

The type of the error is determined from the upper 18 bits of an error 
event cell and the address at vyhich it occurred is determined from the 
lower 18 bits of the cell. The element within which the address is locat- 
ed is determined by inspection of the location counter table in COMMON 
block TABLES. As the JHS is scanned, segment load event cells are used 
to maintain which segments of an overlaid program are loaded. This is 
done by calling subroutine SLTSET once for each segment load event cell 
encountered. The segment load table thus maintained is then used to re- 
solve address ambiguities should any be enountered. 

A walk back to the main routine is provided for each error located if the 
trace has been requested and then only depending on the CUAS preprocessor 
options. The preprocessor options are determined by inspection of cell 2 
of COMMON block CONTRL. If either option A or B was specified to the CUAS 
preprocessor, the walk back is not performed in any case. If neither 
option A or B was specified to the CUAS preprocessor, cell 1 of COMMON 
block CONTRL is inspected to determine if the user desires the walk back 
report. This cell reflects the options specified to the CUAS postprocessor. 

The walk back is performed by proceeding backwards in the JHS from the 
point where an error event cell was encountered. Subroutine call event 
cells are inspected to determine the calling sequence to the element within 
which the error occurred. During this process, the external name table and 
element name table from COMMON block TABLES are used to correlate addresses 
to names. 


Subroutine ELRPT dynamicany allocates the temporary storage needed in order 
to produce the error location report, and then dynamically releases this core 
once the report is finished. This is accomplished by using the subroutine 
6C0RE and RCORE. The amount of dynamic core allocated is dependent solely on 
the size of the diagnostic tables from the absolute element for the program 
under analysis. 

RESTRICTIONS 
e Operational 

Subroutines SLTCLR, SLTSET, 6C0RE, and RCORE and functions ILLSFT, IRRSFT, 
and NGET are required. 


SUBROUTINE FASLT 


IDENTIFICATION 

Name (Title) 
Programmer, Date 
Machine Identification 
Source Language 


- FASLT (Fetch Absolute Segment Load Table) 

- P. H. Horsley, May 1976 

- UNI VAC n 00-Series 

- FORTRAN V 


PURPOSE 

Subroutine FASLT fetches the segment load table from an absolute element in an 
EXEC 8 program file. 


USAGE 

• Calling Sequence 


CALL FASLT 
Arguments : 

Parameter 

name 

(I ERR, ISTAT) 

In/Out Dimension 

Type 

Description 

I ERR 

Out 

1 

I 

Error condition indicator 

ISTAT 

Out 

1 

I 

Value associated with error 
condition 


0 Labeled COMMON 

All of the labeled COMMON block TABLES are required (refer to labeled 
COMMON block description in table 5-1). The core to contain the segment 
load table is dynamically allocated with the location and length of the 
table filled into array MSLT in labeled COMMON block TABLES. 

e Error Messages 

None - all errors are indicated by a nonzero value of the parameter lERR. 
IERR=801 if the dynamic core needed to load the segment load table cannot 
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• be allocated, in which case the parameter ISTAT contains the amount of 
core needed. IERR=802 if the segment load table could not be located in 
the absolute element. 

METHOD 

• Model 

The segment load table is a part of an absolute element as prepared by the 
UNIVAC HAP under EXEC 8. The content and format of an absolute element is 
described in Appendix C. The segment load table is extracted from the 
control bank of the absolute element and read into a block of core which 
is dynamically allocated. The program file and absolute e’.ement are deter- 
mined from the data in labeled COMMON block TABLES. 

RESTRICTIONS 

« Operational 


Subroutines DISKIO and 6C0RE and function IRRSTT are required. 


SUBROUTINE FCODE 


Pi 


s,.? 

s. ■. ■ 

\ ■ 


^1 


1 :-:^ 




IDENTIFICATION 

Name (Title) 
Programmer, Date 
Machine Identification 
Source Language 


- FCODE (Fetch Code) 

- P. H. Horsley, August 1975 

- UNIVAC 1100-Series 

- FORTRAN V 


PURPOSE 

Subroutine FCODE locates the start of the I-BANK code of an element within an 
absolute element residing in an EXEC 8 program file. 






USAGE 

9 Calling Sequence 

CALL FCODE (IWP, lES, IEL, IERR, ISTAT) 
Arguments : 

Parameter 

name In/Out Dimension Type 

IWP In 1 I 


lES 


IEL 

IERR 

ISTAT 


In 


In 


Out 


Out 


Description 

The word number, relative 
0, of the segment name 
table entry describing the 
segment which contains the 
element 

The primary storage address 
of the first location in 
the element's I-BANK 

The primary storage length 
of the element's I-BANK 

An error condition indi- 
cator 

Value associated with 
error indicator IERR 


i 
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a Labeled COMMON 

All of the labeled COMMON blocks TABLES and ACWCNT are required (refer to 
the labeled COMMON block description in table 5-1). The data in COMMON 
block TABLES is used strictly as reference data and no output of data 
occurs through the COMMON block. The array KACW in COMMON block ACWCNT is 
used to return to the calling routine the location of the element's I-BANK 
code. 

a Error Messages 

None - all errors are indicated by a nonzero value of the parameter lERR. 
IERR=401 if the dynamic core needed to expand the array KACW is not avail- 
able, and the parameter ISTAT contains the amount of core needed. 

METHOD 
e Model 

The parameter IWP is used to retrieve the segment data from the segment 
name in table COMMON block TABLES, describing the segment which contains 
the desired element's I-BANK code. The access channel words (ACW's) for 
that segment are inspected to determine the disk location of the element's 
I-BANK code. Disk access directives are returned in COMMON block ACWCNT 
which will enable the calling routine to retrieve the actual code for the 
element. 

RESTRICTIONS 
« Operational 


Subroutines DISKIO, GCORE, and function IRRSFT are required. 




SUBROUTINE FNDELT 


IDENTIFICATION 


Name (Title) 
Programmer, Date 
Machine Identification 
Source Language 


- FNDELT (Find Element) 

- P. H. Horsley, April 1976 

- UNIVAC 1100-Series 

- FORTRAN V 


PURPOSE 

Subroutine FNDELT locates (within the location counter table from an absolute 
element) the entry describing the address of the program element. 


USAGE 

e Calling Sequence 

call FNDELT (lADR, ISP, ISET, LENSET, I RET) 


Arguments : 

Parameter 

name 

In/Out 

Dimension 

Type 

Description 

lADR 

In 

1 

I 

The address for which the 
location counter table 
entry is to be found 

ISP 

In 

1 

I 

Segment name table index 
of segment within which 
address is located 

ISET 

In 

Variable 

I 

Location counter table 
array 

LENSET 

In 

1 

I 

Length of location counter 
table 

IRET 

Out 

1 

I 

Index of entry in location 
counter table describing 
element within which ad- 
dress is contained 
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j • Error Messages 

j None - the parameter IRET is set to -1 if the location counter table entry 

I could not be found. 

I 

! 

j 

I METHOD 

i 

j • Model 

i The location counter table (LOT) is inspected with a linear search for an 

I entry (within the specified segment) which contains the specified address. 

RESTRICTIONS 
9 Operational 

The function IRRSFT is required. 


! 

I 


I 

! 

\ 
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SUBROUTINE GCORE 


IDENTIFICATION 

Name (Title) - GCORE (Get Core) 

- RCORE (Release Core) 

- LCORE (Limits of Core) 

Programmer, Date - P. H. Horsley, March 1976 

Machine Identification - UNIVAC llOO-Series , 

Source Language - UNIVAC llOO-Series Assembler * 

PURPOSE 

The purpose of each of the three entry points follov.'s: 

Entry point GCORE dynamically allocates additional primary storage at the 
end of a program’s D-BANK, or extends the length of a block of primary storage 
previously allocated by subroutine GCORE. 

Entry point RCORE releases blocks of core which were dynamically allocated by 
GCORE. 

Entry point LCORE supplies information as to the core in use and the mode of 
the job executing the program, either demand or batch. 

USAGE 

• Calling Sequence 

CALL GCORE (ITYP, LEN, A, LOC, $LA3) 

Arguments ; 
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Parameter 

name 

In/ Out 

Dimension 

Type 


ITYP 

In 

1 

I 

Set to 1 to request a new 
block of core be allocated 
set to 0 to request exten- 
sion of last block allo- 
cated 

LEN 

In 

1 

I 

The length, in cells, of 
the core to be allocated 

A 

In 

Variable 

I 

The array name to be used 
as the base address for 
referencing the dynamic 
core 

LOG 

Out 

1 

I 

The offset used from array 
A to reference the dynamic 
core. A(1+L0C) will 
reference the first cell 
and A(LEN+L0C) will ref- 
erence the last cell. If 
parameter ITYP=0, LOG is 
not set on return 

$LAB 

In 

- 

* 

The FORTRAN statement 


label number to return to 
if an error occurs 
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CALL RCORECN) 
Arguments: 


Parameter 

name 

In/Out 

Dimension 

Type 

Description 

N 

In 

1 

I 

The number of dynamically 
allocated core blocks to 
release. The blocks re- 
leased are the last N blocks 
allocated by GCORE. If N 
is a negative number, all 
dynamic core blocks are 
released. 

CALL LCORE (INFO) 




Arguments : 





Parameter 

name 

In/Out 

Dimension 

Type 

Descri ption 

INFO 

Out 

5 

I 

INF0(l)=Job type, 4 for 


demand, 5 for deadline 
batch, 6 for normal batch 

INF0(2)=Total core in use 
by program at time of call 

INF0(3)=Maximum core which 
GCORE will allocate for 
caller. A demand job is 
limited to 20K, a batch 
job 65K. 

INF0(4)=The number of blocks 
which have been allocated by 
a type 1 call to GCORE. 

INF0(5)=The maximum number 
of blocks which GCORE will 
allocate 
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1 


X 


9 Error Messages 

None - error conditions are detected only by entry point 6C0RE, and are 
indicated by returning a negative value of the parameter LOG and returning 
to the statement number indicated by the parameter $LAB rather than a nor- 
mal return. The error condition is indicated by the value of the parameter 
LOG, which may take on values as follow: 

-1 = The length of the requested block would exceed maximum core restrictions. 

-2 = The maximum number of blocks which 6C0RE can handle are currently 
allocated. As of this writing, the maximum number is 20. 

-3 = An add core to last block request was made, but no blocks have 
been allocated by GCORE. 

-4 = The parameter LEN is negative, no core was allocated. 


METHOD 


9 Model 


EXEC 8 allocates core to a user program in pages of 512 cells each, with 
the programs I-BANK and D-BANK in disjoint sets of pages. The GCORE sub- 
routine extends a program's D-BANK only by allocating additional pages of 
core at the end of the static D-BANK pages. Subroutine GCORE controls the 
dynamic core by means of logical blocks which are of variable lengths as 
specified by the calling routine. Once a block is allocated, it may be 
extended only if it is the last block allocated by subroutine GCORE. A 
nested block may be made the last block allocated by releasing all blocks 
which were allocated after it. 


New pages are allocated or released dynamically by means of the EXEC 8 
entry points MC0RE$ and LC0RE$, respectively. New pages are allocated only 
if a block will not fit within the unused core in the last page in use by 
the program. 
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RESTRICTIONS 


0 Operational 

This subroutine may not be used to exceed the core limitation requirements 
in force at the NASA/JSC 11 00/ EXEC 8 comiiutiiig facility, A request for more 
core than allowed a demand job will result* in an error return from sub- 
routine GCORE and no additional core willf be' allocated. Subroutine 6C0RE 
is designed to aid the user in installing demand programs and conserving 
storage resources through dynamically allocating only that storage required 
and/or allocating and releasing temporary storage arrays as needed, so that 
temporary storage may share a common address space. 


SUBROUTINE GETOPT 

I ) 

IDENTIFICATION 

Name (Title) - GETOPT (Get Options') * 

Prograimer, Date - P. H. Horsley, December 1975 

Machine Identification - UNIVAC 1100 « Series 
Source Language - UNIVAC 1100 - Series Assembler 

PURPOSE 

Subroutine GETOPT returns the 0XQT options specified when the program calling 
subroutine GETOPT was executed, 

USAGE 

e Calling Sequence 
CALL GETOPT (lOPT) 

Argument; 


Parameter 

name 

In/Out 

Dimension 

Type, 

Description 

lOPT 

Out 

1 

I 

The options in master bit notation 


METHOD 
0 Model 

Subroutine GETOPT does an executive request to the EXEC 8 entry point 0PT$. 
EXEC 8 returns the option word in register AO, which is then stored in 
parameter lOPT. Within lOPT, the options are specified In master bit 
notation, that is, bit 25 is set on if option A was present and bit 0 is 
set on if option Z was present. 


raBCEDING PAGE BLANE‘ NOT FIU& 


SUBROUTINE I ICON! 


IDENTIFICATION 

Name (Title) - IICONT (Contingency Routine) 

Programmer, Date - P. H. Horsley, April 1976 

Machine Identification - UNIVAC 1100 - Series 
Source Language - UNIVAC 1100 - Series Assembler 

PURPOSE 

Subroutine IICONT registers a contingency handler routine with EXEC 8 and traps 
program contingencies when they occur during the execution of a program. Sub- 
routine IICONT is intended for use with the CUAS for creating a jump history 
stack file of a FORTRAN application program execution. This subroutine contains 
no FORTRAN callable entry points, 

USAGE 

• Calling Sequence (Assembly Language) 

LMJ XI 1 ,NINTR$ 

+ 0 
Arguments ; 

One cell must follow the LMJ instruction as the return jump is to Xll +1. 

METHOD 

• Model 

Every UNIVAC EXEC 8 FORTRAN main program includes a reference to the 
external NINTR$ as the first executable instruction of the program. The 
purpose of the subroutine containing the external name NINTR$ is to register 
a contingency handler routine with EXEC 8. A contingency routine Is 
described In UNIVAC Publication 4144, Revision 3, Section 4.9. 

A standard contingency handler routine is provided in the UNIVAC FORTRAN 
library. Subroutine IICONT performs the same functions as the standard, 
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but has the expanded capability to create a ^JHS of a FORTRAN program ex- 
ecution. The JHS content and fomat as created by subroutine IICONT is 
described in Appendix D. The tracing of program errors is done directly 
by trapping the errors in the normal way and then inserting this infor- 
mation into the JHS. The tracing of subroutine calls and jumps is done 
by interpreting an illegal operator (lOPR) interrupt as an expected event 
which signals that control is to be transferred to or from a subroutine. 
The transfer is performed by a software execution of the instruction, and 
the fact that the transfer was made is inserted into the JHS. 

Subroutine IICONT also contains the code for performing segment loads 
when segment loading is by the indirect method. This code has the ex- 
panded capability to record into the JHS the fact that the segment was 
loaded. 

r 

RESTRICTIONS 
• Operational 

Ten cells are reserved immediately preceding the entry cell NINTR$. These 
10 cells are used as a communication area between the CUAS preprocessor 
and subroutine IICONT. Any change in the length, location, or format of 
these 10 cells will require compatible changes be done in the CUAS preproc- 
essor. The 10 cells contain the following information: 

Cell Description 

1-2 The fieldata name of the absolute element within which 

IICONT is contained 

3-4 The fieldata version name of the absolute element within 

which IICONT is contained 

5 The time and date of creation of the absolute element 

6 A sentinel cell set to the octal value (666666666666) by the 
CUAS preprocessor 
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Cell 


Description 


7 The start address of the indirect load table in this absolute 
el ement 

8 The last address of the indirect load table in this absolute 
el ement 

9 The CUAS preprocessor options in master bit notation 

10 A sentinel cell set to the octal value (666666666666) 

When the CUAS preprocessor is executed, it examines cell 10 of the area 
and if it does not contain the specified sentinel, the preprocessor assumes 
that the incorrect version of NINTR$ has been included in the absolute. 

The first nine cells of the area are filled in by the preprocessor as part 
of its task of modifying the absolute code. Cell 6 of the area is used 
by subroutine IICONT to determine if the absolute element has been modi- 
fied by the preprocessor. If the specified sentinel is not found in cell 
6, it is assumed that the absolute has not been modified. If the code has 
been modified, cells 1-5 and cell 9 of the area are passed on the the CUAS 
postprocessor by inserting them into the jump history stack file. 

Any change of the location, order, format, or length of this 10-cell area 
without compatible changes in the CUAS preprocessor will result in improper 
operation of the entire CUAS. 

The timing subroutine contained within subroutine IICONT is designed for 
operation on the EXEC 8 operating system in use at NASA/JSC as of this 
writing. The formulas used by this routine in computing timing charges 
may be found in Appendix A. The technique for determining time is, in 
general, EXEC 8 installation dependent. 


FUNCTION ILLSFT 


IDENTIFICATION 

Name (Title) - ILLSFT (Logical Left Shift) 

- IRRSFT (Logical Right Shift) 

- ICLSFT (Circular Left Shift) 

- ICRSFT (Circular Right Shift) 

Programmer, Date - P. H. Horsley, August 1975 

Machine Identification - UNIVAC 1100 - Series 

Source Language - UNIVAC 1100 - Series Assembler 

PURPOSE 

The purpose of each of the four entry points follows: 

Entry point ILLSFT performs a logical left shift on a single cell. Bit posi- 
tions vacated are zero filled, bits shifted out are lost. 

Entry point IRRSFT performs a logical right shift on a single cell. Bit posi- 
tions vacated are zero filled, bits shifted out are lost. 

Entry point ICLSFT performs a circular left shift on a single cell. Bits 
shifted out of the upper left position are reentered at the lower right. 

Entry point ICRSFT performs a circular right shift on a single cell. Bits 

shifted out of the lower right position are reentered at the upper left. 

USAGE 

• Calling Sequence 

I = ILLSFT (IVAR, NUB) 

Arguments : 


Parameter 

name 

In/Out 

Dimension 

Type 


Description 

IVAR 

In 

1 

I 

The cell 
left 

containing the bits to shift 
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Parameter 


name 

In/Out 

Dimension 

Type 

Description 


NUB 

In 

1 

I 

The number of fait positions to shift 
left in IVAR 

I 

Out 

1 

I 

The shifted cell as the function 
IVAR ,1s unchanged 

value. 

I = IRRSFT {IVAR, 
Arguments : 

NUB) 




Parameter 

name 

In/Out 

Dimension 

Type 

Description 


IVAR 

In 

1 

I 

The cell containing the bits to 
right 

shift 

NUB 

In 

1 

I 

The number of bit positions to shift 
right in IVAR 

I 

Out 

1 

I 

The shifted cell as the function 
IVAR is unchanged 

value. 

I = ICLSFT (IVAR. 
Arguments: 

NUB) 

i 



Parameter 

name 

In/Out 

Dimension 

Type 

Description 


IVAR 

In 

1 

I 

The cell containing the bits to 
cular shift left 

cir- 

NUB 

In 

1 

I 

The number of bit positions to shift 
left in IVAR 

I 

Out 

1 

I 

The shifted cell as the function 
IVAR is unchanged 

value. 

I « ICRSFT (IVAR, 
Arguments : 

NUB) 


• 


Parameter 

name 

In/Out 

Dimension 

Type 

Description 


IVAR 

In 

1 

I/R 

The cell containing the bits to 

cir- 


cular shift right 


Parameter 


name 

In/Out 

Dimension 

Type 

Description 

NUB 

In 

1 

I 

The number of bit positions to shift 
right in I VAR 

I 

Out 

1 

I 

The shifted cell as the function value. 
IVAR is unchanged. 


ft Error Messages 

None - for all four entry points, the value of the parameter NUB is checked 

and if it is less than or equal to zero, or greater than 36, no shift is 

performed and a return to the caller is done. 

METHOD 
ft Model 

All four entry points insert the value of the parameter NUB into the 
appropriate machine instruction and then that instruction is executed to 

perform the shift. The shifted value is in register AO when the subroutine 

returns to the caller. The calling sequence to all four entry points con- 
form to FORTRAN conventions in that they are referenced by an LMJ instruc- 
tion using Xll, and the return point allows for the FORTRAN walk back word. 
Subroutine SHIFTY uses only registers AO and Xll. 
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SUBROUTINE LADTAB 



( 


IlENTIFICATION 


Name (Title) 
Programmer, Date 
Machine Identification 
Source Language 


- LADTAB (Load Absolute Tables) 

- P. H. Horsley, March 1976 

- UNI VAC 1100-Series 

- FORTRAN V 


PURPOSE 

Subroutine LADTAB allocates primary storage for the diagnostic tables and 
then reads them into that area from the last absolute element inserted into 
a program file. 


USAGE 

• Calling Sequence 

CALL LADTAB (I ERR, ISTAT) 
Arguments: 

Parameter 


name 

In/Out 

Dimension 

Type 

Description 

lERR 

Out 

1 

I 

An error condition indicator 

ISTAT 

Out 

1 

I 

A status value associated 


with the error condition 


• Labeled COMMON 

All of COMMON block TABLES is required (refer to the labeled COMMON de- 
scription in table 5-1). The size of the COMMON block is dynamically 
expanded to exactly contain the tables from an absolute element. 
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Error Messages 




None - all error conditions are indicated by a nonzero value of the param- 
eter lERR. IERR=101 if the core for the tables could not be allocated, 
in which case parameter ISTAT contains the amount of core needed. IERR=102 
if the file referenced is not a program file. IERR=103 if no absolute 
element exists in the referenced file. fERR=104 if the absplute element 
does not contain diagnostic tables. 

METHOD 

• Model 

The sequence number of the last absolute elemenii inserted into the program 
file is determined from the program file header table. The sector address 
and size of the diagnostic tables is determined from the header table for 
the absolute element. Core is expanded to hold the tables by calling sub- 
routine GCORE and then the tables are read into that area by calling sub- 
routine DISKIO. 

RESTRICTIONS 

• Operational 

Subroutines GCORE, RCORE, and DISKIO, and function IRRSFT are required. 


{ 

SUBROUTINE MINJ I 


IDENTIFICATION 

Name (Title) - MINT (Modify Instryction) 

Programmer, Date - P. H. Horsley, April 1976 

Machine Identification - UNIVAC 1100-Sertes 

Source Language - FORTRAN V 

PURPOSE 

Subroutine MINT scans the I-BANK code of an absolute element and modifies the 
operation code of LHJ and J instructions to illegal operation codes. 

USAGE 

• Calling Sequence 


CALL MINT (lOPTWD, 
Arguments: 

NIWD, lERR, ISTAT) 



Parameter 

name 

In/Out 

Dimension 

Type 

Description 

The OXQT options in master 
bit notation 

lOPTWD 

In 

1 

I . 

NIWD 

Out 

1 

I 

The index of the third cell 
in the external name table 
for the name NINTR$ 

I ERR 

Out 

1 

I 

An error condition indicator 

ISTAT 

Out 

1 

I 

A status value associated 
with lERR 


• Labeled COMMON 

All of the labeled COMMON blocks TABLES and ACWCNT are required (refer to 
the labeled COMMON block description in table 5-1). The COMMON blocks are 
used strictly as reference data, and no output of data occurs through the 
COMMON blocks. 

• Error Messages 

None - all error conditions are indicated with a nonzero value of the pa- 
rameter lERR. IERR=201 if dynamic core cannot be allocated for local 
working arrays, in which case parameter ISTAT contains the amount of core 
needed. 

METHOD 
0 Model 

The I-BANK code for each user-supplied element of the absolute is scanned 
for LMJ instructions to an external reference and J instructions which 
will transfer control outside of the element being scanned. These in- 
structions are then modified by inserting into the operation field an 
octal 7700 for an LMJ and an octal 7701 for a 0 instruction. Any element 

which was obtained from the SYS$*RLIB$. file or any element which contains 

a $ character within its name is not scanned and modified. Similarly, any 
LMJ instruction which will transfer control to an address in such an element 
is not modified. The element IICONT is not modified and any LMJ to the 
entry point NINTR$ is not changed to an illegal operator. A J instruction 

is always modified if an index register is used in forming the jump to 

address. When no index register is used, the instruction is modified only 
if the jump to address is outside the range of the element containing the 
J instruction, or if the address is indirect. 

RESTRICTIONS 

• Operational 

Subroutines GCORE, RCORE, CKDOLR, FNOELT, and FCODE and functions IRRSFT, 
ICLSFT, and ICRSFT are required. 
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FUNCTION NGET 

t ! 

IDENTIFICATION ^ ^ 

Name (Title) - NGET (Next Get) 

Programmer, Date - P. H. Horsley, December 1975 

Machine Identification - UNIVAC 1100 - Series 
Source Language - FORTRAN V 

PURPOSE 

Function NGET returns to the caller a single cell of the Code Usage Analysis 
System (CUAS) Jump History Stack File (JHSF) as the value of an integer func- 
tion. The desired cell number is furnished to the function in a calling 
argument. 

USAGE 

• Cal 1 i ng Sequence 
I = NGET (NB, $LABEL) 

Arguments : 


Parameter 

name 

In/Out 

Dimension 

Type 

Description 

NB 

In 

1 

I 

The number of the desired cell from 
the JHSF 

$LABEL 

In 

1 

I 

The label of the statement returned to 
if the requested cell is outside the 
JHSF range, that is, an end -of -file 
condition 

NGET 

Out 

1 

I 

The content of the requested cell from 
the JHSF 


e Labeled COMMON 

All of COMMON block JHSCNT is required (refer to the labeled COMMON 
description in table 5-1). COMMON block JHSCNT is used strictly for 
reference and no OUTPUT of data occurs through the COMMON block. 
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• Error Messages 

None - if the caller attempts to reference a cell outside the JHSF limits, 
a nonstandard return through parameter 2 is performed. 

METHOD 

• Model 

When function NGET is called, the variable NSIJHS is examined and if zero, 
N6ET assumes this is the initial call to the routine. The first four 
sectors of the JHSF are retrieved and the variables NSIJHS, IBIMM, and 
LBIMN are initialized. Once these variables are initialized, the first 
call and succeeding calls determine the block number within which the 
requested cell, in parameter NB, is contained. A block is defined as four 
28-cell sectors as 112 total cells. If the necessary block is currently 
in the I/O buffer array IBUF, as indicated by the variable IBIMN, the 
requested cell is retrieved and returned as the value of the function. 

If the necessary block is not in the I/O buffer array IBUF, the block is 
retrieved from the JHSF and the variables IBIMN, LBIMN are updated. The 
variable LBIMN reflects the actual length of each I/O transfer which could 
be fewer than four sectors if a request exceeds the length of the JHSF but 
starts within it. 

The first four cells of COMMON block JHSCNT must be initialized prior to 
the first call to function NGET. 


RESTRICTIONS 
• Operational 

The subroutine DISKIO is required. The named COMMON block JHSCNT is con- 
sidered the sole property of this function and no other subroutines of a 
program which use the function should alter the content of the COMMON 
block in any way except to set initial values in it prior to the first 
call to function NGET. Failure to adhere to this restriction will result 
in unpredictable operation of function NGET. 
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SUBROUTINE OPNEOR 


IDENTIFICATION 

Name (Title) - OPNEOR (Open Output Routine) 

Programmer, Date - D. M. Braley, May 1973 

Author, Date - P. H. Horsley, June 1976 

Machine Identification - UNIVAC llOO-Series 

Source Language - UNIVAC 1100-Series Assembler 

PURPOSE 

Subroutine OPNEOR oepns a symbolic element for line image output into an 
EXEC 8 program file. 

USAGE 

9 Calling Sequence 
CALL OPNEOR ($LAB) 

Arguments : 

Parameter 

name In/Out Dimension Type Description 

$LAB _ - - jhe label number to return 

to if element is not 
successfully opened 


METHOD 
• Model 

The UNIVAC-supplied package SOR is utilized to open the source element. 
SOR is documented in U.P. 4144, Rev. 3. 


RESTRICTIONS 


• Operational 

The subroutine PTABLE must be called to initialize the element directory 
packet before subroutine OPNEOR is called. 


SUBROUTINE OUTIMG 




IDENTIFICATION 

Name (Title) - OUTIMG (Out Image) 

Pragrammer, Date - D. M. Braley, May 1973 

Author, Date - P. H. Horsley, June 1976 

Machine Identification - UNIVAC 1100-Series 
Source Language - UNIVAC 11 00- Series Assembler 


PURPOSE 


Subroutine OUTIMG inserts a single line image into a source element which has 
been opened In an EXEC 8 program file. 


USAGE 

• Calling Sequence 

CALL OUTIMG (IMAGE, $LAB) 
Arguments : 

Parameter 

name In/Out Dimension 

IMAGE In 14 


$LAB 


Type Description 

I The line image to insert into 
the element, containing six 
fi el data characters per call 

The label number to return 
to if the line is not suc- 
cessfully inserted 


METHOD 
• Model 

The UNIVAC-supplied package SOR is used to insert a source image into an 
open element in a program file, SOR is documented in U.P. 4144, Rev. 3. 
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f 


RESTRICTIONS 
9 Operati onal 

The subroutine OPNEOR must be called to open a source element in a program 
file before the initial call to subroutine OUTIMG. 


? , 

! 



I 
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SUBROUTINE PARTBL 


IDENTIFICATION 

NAME (Title) - PARTBL (Part Table) 

Programmer, Date - D. M. Braley, May 1973 

Author, Date - P. H. Horsley, June 1976 

Machine Identification - UNIVAC 1100-Series 

Source Language - UNIVAC 1100-Series Assembler 

PURPOSE 

Subroutine PARTBL defines the array PARTBL for use by the UNIVAC SOR package 
in creating a source element in an EXEC 8 program file. 

USAGE 

This routine contains no FORTRAN callable entry points. It should be in an 
absolute element if subroutine PTABLE is used in the absolute element. 

METHOD 
• Model 

The symbolic name PARTBL is defined as an external address, and 40 cells 
of primary storage under location counter 0 are reserved, starting at the 
address. The format of the array PARTBL is documented in U.P. 4144, 

Rev. 3, p. 9-21. 


SUBROUTINE PREERR 


IDENTIFICATION 

Name (Title) - PREERR (Pre-Error) 

Programmer, Date - P, H. Horsley, April 1976 

Machine Identification - UNIVAC 1100-Series 

Source Language - FORTRAN V 

PURPOSE 

Subroutine PREERR prints all error messages for the Code Usage Analysis 
System (CUAS) preprocessor. 

USAGE 

• Calling Sequence 

CALL PREERR (I ERR, ISTAT, I UN) 

Arguments: 

Parameter 


name 

In/Out 

Dimension 

Type 

Description 

I ERR 

In 

1 

I. 

A number indicating the 
routine in which an error 
occurred and the error 
type 

ISTAT 

In 

1 

I 

Descriptive information 
about the error 

I UN 

In 

1 

I 

The name of the program 
file containing absolute 
elements being processed 
by CUAPREPRO 


j^CBDINQ PA.G® BLAUS- NOT 
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T 
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a Error Messages 

This routine prints fully descriptive error messages for the total CUAS 
preprocessor. 

METHOD 
a Model 

Each error-producing subroutine of the CUAS preprocessor is assigned a 
unique routine number. When such a routine .detects an error condition, 
an error cell is set with the detecting routine number (DRN) and the 
error type (ET). The two numbers are combined in the one cell by the 
‘formula IERR=DRN*100+ET. Subroutine PREERR decodes the error cell, which 
is passed to it as parameter lERR, and prints the appropriate error mes- 
sage format. The parameter ISTAT is used to pass any additional needed 
information to be printed in the error message. This technique of handling 
error messages allows for all error formats to be included in one element 
which may be inserted in an overlay segment and is thus never loaded unless 
an error is detected during processing. 

RESTRICTIONS 
• Operational 

The subroutine LCORE is required. 
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SUBROUTINE PSTERR 


IDENTIFICATION 

Name (Title) 
Programmer, Date 
Machine Identification 
Source Language 


PSTERR (Post Error) 

- P. H. Horsley, May 1976 
UNIVAC 1100-Series 

- FORTRAN V 


PURPOSE 

Subroutine PSTERR prints all error messages for the Code Usage Analysis 
System (CUAS) postprocessor. 


USAGE 

0 Calling Sequence 
CALL PSTERR (lERR, 
Arguments: 

Parameter 

ISTAT) 



name 

In/Out 

Dimension 

Type 

Description 

I ERR 

In 

1 

I 

A number indicating the 
routine in which an error 
occurred and the error type 

ISTAT In 

0 Labeled COMMON 

1 

I 

Descriptive information 
about the error 


All of the labeled COMMON blocks TABLES, JHSCNT and CONTROL is required. 
The data in these COMMON blocks is used strictly as reference information, 
and no output occurs through the COMMON blocks. 


- j=- 
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• Error Messages 


This routine prints error messages for the total CUAS postprocessor, with 
the messages fully descriptive of the error which has occurred. 

METHOD 
• Model 

Each error-producing subroutine of the CUAS postprocessor is assigned a 
unique routine number. When such a routine detects an error condition, 
an error cell is set with the detecting routine number (DRN) and the error 
type (ET). The two numbers are combined in the one cell by the formula 
IERR='DRN*100+ET. Subroutine PSTERR decodes the error cell, which is passed 
to it as parameter lERR, and prints the appropriate error message format. 
The parameter ISTAT is used to pass any additional needed information to 
be printed in the error message. This technique of handling error messages 
allows for all error formats to be included in one element which may be 
inserted into an overlay segment and is thus never loaded unless an error 
is detected during processing. 

RESTRICTIONS 
e Operational 

Subroutines BD2FD and LCORE are required. 


SUBROUTINE PTABLE 


IDENTIFICATION 


Name (Title) 
Programmer, Date 
Author, Date 
Machine Identification 
Source Language 


PTABLE (Part Table) 

D, M. Braley, May 1973 
P. H. Horsley, June 1976 
UN I VAC n 00-Series 
UNIVAC 1100-Series Assembler 


PURPOSE 

Subroutine PTABLE initializes an externalized array named PARTBL for the 
UNIVAC source element creation package SOR. 

USAGE 

• Calling Sequence 

CALL PTABLE (10, lOPT, INOUT, IPKT) 


Arguments : 

Parameter 

name 

In/Out 

Dimension 

Type 

Description 

10 

In 

1 

I 

Selection option, 

0 = insert options word 

into the packet 

1 = Source input 

2 = Source output 

I OPT 

In 

1 

I 

1 for data input if file 
name, 2 if element packet, 
3 if both 

INOUT 

In 

1 

I 

0 = move data from PARTBL 

into IPKT 

1 = move data from IPKT into 

PARTBL 
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Parameter 

name 

In/Out 

Dimension 

Type 

Description 

IPKT 

In/Out 

12 

I 

The packet which describes 
the element, which becomes 
cells 2-13 of array PARTBL. 


METHOD 
• Model 

Subroutine PTABLE Initializes an externalized array of data which the 
UNIVAC SOR package uses to create a new source element in an EXEC 8 
program file. The format of the array is described in U.P. 4144, Rev. 3, 
p. 9-21. 


RESTRICTIONS 
• Operational 

The subroutine PARTBL is required which contains the externalized array 
PARTBL. This routine is normally used in conjunction with subroutines 
OPNEOR, OUTIMG, and CLSEOR, with the following calling sequence. 

CALL PTABLE (10, lOPT, INOUT, IPKT) 

CALL OPNEOR ($100) 

CALL OUTIMG (IDAT, $100) {1 call per line} 


CALL OUTIMG (IDAT, $100) 

CALL CLSEOR ($100) 

At this point, a new source element has been inserted into a program file in 
accordance with the data in array PARTBL. 
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SUBROUTINE SLRPT 


IDENTIFICATION 

Name (Title) 
Programmer, Date 
Machine Identification 
Source Language 


- SLRPT (Segment Loading Report) 

- P. H. Horsley, December 1975 

- UNI VAC n 00-Series 

- FORTRAN V 


PURPOSE 

Subroutine SLRPT produces the CUAS segment loading report and is intended for 
use only with the CUAS postprocessor. 


USAGE 

• Calling Sequence 

CALL SLRPT (lERR, ISTAT) 
Arguments : 


Parameter 

name 


ISTAT 


In/Out 


Dimension 


Type Description 

I An error indicator, set 

nonzero to indicate an 
error and type 

I A status flag associated 

with the error type 


Labeled COMMON 

All of the labeled COMMON blocks TABLES and CONTRL are required (refer to 
labeled COMMON block description in table 5-1). The data in both COMMON 
blocks is used strictly as reference data and no output occurs through the 
COMMON blocks. 
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• Error Messages 

None - all errors are indicated by a nonzero value of the parameter lERR, 
IERR=1001 if an I/O error occurred on file JHS. IERR=1002 if dynamic core 
is not available for local storage arrays, in which case ISTAT contains 
the amount of core needed. 

METHOD 

• Model 

Subroutine SLRPT scans the CUAS JHS to locate segment load event cells 
entered in the file by the CUAS contingency routine IICONT. The content 
and format of the JHS is presented in Appendix D. A sum of the total 
loads for each segment is maintained and once the entire JHS has been 
scanned, a report of the total loads for each segment is reported. The 
subroutine which when called resulted in a segment being loaded is deter- 
mined from the subroutine call event cell in the JHS immediately following 
a segment load event cell. This information is also included in this 
report. 

The names of the segments and subroutines are determined by correlating 
indexes and addresses respectively with the segment name table and external 
name table in COMMON block TABLES. 

Subroutine SLRPT dynamically allocates the temporary storage needed in 
order to produce the segment loading report, and then dynamically releases 
the storage once the report is finished. This is accomplished fay using 
the subroutines GCORE and RCORE. The amount of dynamic storage allocated 
is dependent solely on the size of the diagnostic tables from the absolute 
element for the program under analysis. 

RESTRICTIONS 

The subroutines GCORE and RCORE, and functions NGET, ILLSFT, and IRRSFT 
are required. 
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SUBROUTINE SLTSET 


IDENTIFICATION 


Name (Title) 

Programmer, Date 
Machine Identification 
Source Language 


- SLTSET (Segment Load Table Set) 

- SLTCLR (Segment Load Table Clear) 

- P. H. Horsley, September 1975 

- UN I VAC 11 00-Series 

- FORTRAN V 


PURPOSE 

Entry point SLTSET updates the segment load table such that it reflects the 
loaded segments of a segmented program. 


Entry point SLTCLR resets the segment load table to initial load conditions, 
that is, only the root segment of a segmented program is loaded, 

USAGE 

• Calling Sequence 

CALL SLTSET (ISLT, LSLT, ISEG) 

CALL SLTCLR (ISLT, LSLT) 

Arguments : 


Parameter 

name 

In/Out 

Dimension 

Type 

Description 

ISLT 

In/Out 

LSLT 

I 

The segment load table which 
is updated and returned to 
the caller 

LSLT 

In 

1 

I 

The length, in cells, of the 
segment load table 

ISEG 

In 

1 

I 

The index of the segment 
which is to be indicated as 
loaded in the segment name 
table 


METHOD 


B Model 

In order to resolve addressing ambiguities, the CUAS postprocessor must be 
able to determine which segments of a segmented program were in primary 
storage at any point during execution of a program. Subroutine SLTSET 
maintains the segment load table such that this determination may be made. 
The table 1s maintained exactly In format and content as It Is by the 
EXEC 8 entry point L0AD$ during the execution of a program. The table may 
thus be examined by any other subroutine to determine which segments of an 
overlaid program were loaded at any time. 

Subroutine SLTCLR merely clears the segment load table such that It reflects 
only the root segment loaded. 

RESTRICTIONS 
• Operational 

Function IRRSFT is required. 
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SUBROUTINE SUPTIM 


IDENTIlFICATION 

Name (Title) 
Programmer, Date 
Machine Identification 
Source Language 


- SUPTIM (SUP Time| 

- P. H. Horsley, Februkry '1976 

- UNIVAC 1100-Series' 

- UNIVAC n 00-Series Assembler 


PURPOSE 

Subroutine SUPTIM retrieves the total Standard Unit of Processing (SUP) 
charges for an EXEC 8 job at the time of the call to the subroutine. 


USAGE 

t Calling Sequence 

CALL SUPTIM (ICAU, ICCER, 10) 
Arguments : 

Parameter 


name 

In/Out 

Dimension 

ICAU 

Out 

1 

ICCER 

Out 

1 

10 . 

Out 

1 


METHOD 


Type Description 

I The CAU time in 200 micro- 
second increments 

I The executive time in 200 
microsecond increments 

! The I/O time in 200 micro- 
second increments 


t Model 

The charges for a job running under EXEC 8 are maintained in an EXEC 8 
controlled list called the Program Control Table (PCT). Subroutine SUPTIM 
references the PCT to retrieve the time charges for a job. The PCT is 
available for reference by an application program as a read-only D-BANK. 


Subroutine SUPTIM reads the PCT by dropping the control D-BANK and basing 
the PCT oh the primary Processor State Register (PSR). The control D-BANK 
is re-based on the primary PSR prior to returning to the caller. 

RESTRICTIONS 

• Operational 

The UNIVAC LDJ instruction is used to base the PCT and the address of the 
PCT is supplied by the UNIVAC MAP in the external address tag RPCTA$. The 
effective PCT address is RPCTA$-1 on the 1108 hardware and the RPCTA$ on 
the 1110 hardware, thus a different version of this routine is required 
for each machine. The CAU time is also maintained in a different manner 
on the 1110 than it is on the 1108. Two versions of subroutine SUPTIM 
are available, one for the 1110 and one for the 1108, and are distinguished 
by the version names U1108 for the 1108 version and UlllO for the 1110. 

The formulas used by subroutine SUPTIM for calculating SUP charges may be 
found in Appendix A. 
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bJBROUTINE SUSRPT 


IDENTIFICATION 


Name 

Programmer, Date 
Machine Identification 
Source Language 


- SUSRPT (Subroutine Usage Report) 

- P.H. Horsley, May 1976 

- UN I VAC 1100-Series 

- FORTRAN V 


PURPOSE 

• i 

Subroutine SUSRPT creates a source element in a UNIVAC EXEC 8 program file. 
The element created contains the names of the subroutine elements used and 
not used during the execution of the program which created file JHS for 
analysis by the CUAS postprocessor. 


USAGE 


• Calling Sequence 

CALL SUSRPT (lERR, ISTAT) 
Arguments : 


Parameter 

name 

In/Out 

Dimension 

Type 

Description 

lERR 

Out 

1 

I 

An ev*ror condition indicator 

ISTAT 

Out 

1 

I 

A status value associated 
with lERR 


• Labeled COMMON 

All of the labeled COMMON block TABLES is required (refer to labeled COMMON 
block description in table 5-1). The data in the COMMON block is used 
strictly as reference information, ana no output of data occurs through 
the COMMON block. 


None - all errors are indicated by a nonzero value of the parameter lERR. 
IERR=nd1 if file' ;D^ v/as not successfully assigned, in which case ISTAT 
contains the facility status bits for rejection, IERR=1102 if no name was 
supplied for the source el etiieht to be created. IERR=1003 if an I/O error 
occurred on file DBF. 

METHOD ' 

0 'Model ' 

Subroutine SIJSRPt initi,a1ly attempts to dynamically assign file DBF 
exclusively. If the file cannot be assigned exclusively, execution is 
suspended for 30,000 milliseconds and then another attempt is made to 
assigned exclusively. A source element is then opened in the file, and 
the names of subroutines used and not used are Inserted into the file, one 
names of subroutines used and not used are inserted into the file, one 
source line per subroutine name. Once the element is created, the file 
DBF is dynamically freed so that other jobs running concurrently may 
assign and use it, 

RESTRICTIONS - 

» > Operatiprial 

Subroutines CSFERi WAITER, LCORE, PTABLE, OPNEOR, OUTIMG, CLSEOR, and 
BD2FD are required. 



SUBROUTINE WAITER 


iPENTIFIGATION 


Name (Title) 

Programmer t Date 
Machine Identification 
Source Language 


- WAITER (Wait Exec Request) 

- P, H. Horsley, May 1976 

- UNIVAC 1100-Series 

- UNIVAC 1100-Series Assembler 


PURPOSE 


t 


Subroutine WAITER performs an executive request to the EXEC 8 entry point 
TWAIT$, which will delay executive for a specified interval of time. 


USAGE 

• Calling Sequence 
CALL WAITER (ITIME) 

Argument: 

Parameter 

name In/Out Dimension Type 

ITIME In 1 I 


Description 

The time, in milliseconds, 
for program execution to 
be delayed. The upper 
limit is 30,000 milli- 
seconds. 


METHOD 
f Model 

An executive request is performed to the EXEC 8 entry point TWAIT$ with 
the value of parameter ITIME in register Al. Upon return from the request, 
control is immediately returned to the caller. 
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SUBROUTINE XRRPT 

IDENTIFICATION 

Name, (Title) - XRRPT (EXterhaV Reference ReppH^ 

Programmer, Date ' > P^H. Horsley, December 1975 

Machine Identification - UNIVAC 1100-Series 

Source Language - FORTRAN V 

PURPOSE • 

Subroutine XRRPT produces the' CUAS external ‘ reference report and is intended 
for use only with the GUAS postprocessor. 

USAGE 

• Calling Sequence 
GALL XRRPT (lERRilSTAT) 

Arguments; 

Parameter 

/ .name;.' : In/Out Dimension Type 

lERR Out 1 1 

ISTAT Out 1 I 

• Labeled COMMON 

All of the labeled COMMON blocks TABLES and CONTRL are required (refer to 
labeled COMMON block description in table 5-1). The data in both COMMON 
blocks is used strictly as reference data and no output of data occurs 
through the COMMON blocks. 


Description 

An errof indicator, set 
nonzero to indicate an 
error and type 

A status flag associated 
with the error type 


f Eif’ror Messages 

None - all errors are Indicated by a nonzero value of the parameter lERR. 
IERR=T201 if the dynamic core for local storage arrays is not available, 
in which case parameter ISTAT contains the amount of core needed. IERR=1202 
if an I/O error occurred on, file OHS, 

METHOD 
t Model 

The preprocessor execution options, which are available in COMMON block 
CONTRL, are examined to determine the type of report to be produced. The 
OHS is scanned to obtained data about the program execution under analysis. 
The content and format of the OHS is presented in Appendix D. 

t 

If option G was specified on the postprocessor execution, bits 16 and 17 
of the date cell of each element name entry are used to indicate if the 
element was used (01), not used (10) or nonuser-supplied element (00). 

This data is used by subroutine SUSRPT to generate a source element con- 
taining the naines of subroutines used and not used. 

Subroutine XRRPT dynamically allocates the temporary storage needed in 
order to produce the external reference report, and then dynamically re- 
leases the storage once the report is finished. This is accomplished by 
using the subroutines 6C0RE and RCORE. The amount of dynamic storage 
allocated is dependent solely on the size of the diagnostic tables from 
the absolute element for the program under analysis. 

RESTRICTIONS 
t Operational 

The subroutines GCORE, RCORE, SLTCLR, SLTSET, CKDOLR, BD2FD, FNDELT, and 
BUBSRT, and functions NGET, IRRSFT, and ILLSFT are required. 



5.6 SAMPLE RUN STREAM/OUTPUT 

The following pages contain the reports generated by the CUAS postprocessor 
during the execution of the run streatn below. 


1 . mn 

2. (3ADD,P FM9*SVDSDECKS.SETUP/'MS37 

3. @MAP,S FH9*QQINPT.SVD5,R0v,^^ 

4. @XQT .SVDS 

5. @ADD,P TCL.DECK3 : / ' 

6. ' @U’S5 SI..,SV. 

7. @C0PY,R FML-E79351*PHPA.nC0i^^^^^ 

8. @MAP,S SI.SVDS1,R0.,S0. : v ^ V v 

9. @XQT,C FML-L79351*PHPA.CUAPREPR0 

10. mSGJ JHS.,F4/10//10 

11. ©XQT .SVDSl 

12. @XQT FML-L79351*PHPA.CUAPSTPR0 

13. @FIN 

Note that statements 7, 9, 10, and 12 are included solely for the use of the 
eUAS on the absolute element SVDSl in file TPF$. The C option on statement 
9 invokes the subroutine timing option of the GUAS. Statement 10 overrides 
the default size of the file JHS and specifies a maximum size of 10 tracks. 
Once 10 tracks of data have been collected, program analysis will terminate 
automatically. 
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08/12/7? 
08/12/76 
08/1 2/76 
08/12/76 
08/12/76 

08/12/76 
08/12/76 
08/1:2/76 
08/12/76 
08/12/76 
08/12/76 
08/12/76 
08/12/76 
06/02/76 
D7/08 /76 
08/ 12/76 
07/08/76 
03/02/76 

06/12/76 

Q9/ 05/75 

08/05/76 
08/12/76 
07/08/76 
08/12/76 
09/05/75 
1 1/ 05/75 
dl/«19/76 
05/08/76 
□8/12/76 
05/30/73 
00/12/76 
08/12/76 
08/12/76 

08/12/76 

08/12/75 

08/12/76 

08/12/76 

□6/12/76 

08/12/76 


CREATION 

: (..T ime.:.- ; 

2i; 12JH9 
18110147 
2111215D 
16131 :hb 

161215142 

14103102 
I6l52:jj7 
2 1 11 2 : 51 
2lll2f5l 
08137145 
211 12151 
211 12; 51 
21112152 
211 12 1S2 
21H 21 52 
2| 112152 
21142152 
21112; 52 
21112153 
2,4 i 1 2:53 
21H 2153 
2 I ll 2153 
21112153k 
21 14 2154 
14103135 

oai-wiBj 
2114 2^54 
OSlH'i ; S6 
4 6133103 
21M2S56 
18137106 
131051 16 
211 i 2lS7 
□8 146119 
21112157 
18140135 
1 1109101 
09147:00 
13106 127 
2 111 2 ; 58 
07116149 
21 1121 §0 
24112158 
211 12:58 
2 4 112158 
2114 2158 
21112158 
21112»59 
2 MI 2159 
21112!59 


1 1 

&| 

SB 

EJ a 
■o ^ 


rfJAHe 

rSTRcS 

SUPbaI 

GNTeRP 

«TU8i^ 

I4EAT 

HSTQIF 

1 0 Jt 

inTtal 

iMTlfiA 


pname 

FSTRCS 


IWTEGc 
tUTgRP 
I mTQ li 
ll?TGlS 

ITEReX 

pi 

lIneup 

lloaq 

»,NCHID 
LOAOIT 
rate 07 
HATRoT 

HCBi 02 

HEASl 
MHDE 
hmP&n 
«KOI 
MR DO 
MOPEi I 
MQNIT2 
mqVer 


filHBAt 

fiLPOAL 

GNTeRP 

HSTOIF 

ttcont 

I N I TaU 
I NT EG A 

iNTEG3 

INTEGS 

inTerp 

♦NTGfi 

INTGIP 

TTeRE^ 

Jst THO 


? RACER 
UIHSeT 
ctnect 
LUO AO 


NA»ESP 

naVi 

!lS5?r 

ORPDaT 

SillEi 

OUTPRr 

pARAi B 

PCTO 

PHScs 

PHSIi^T 

plTint 

PHATRX 

PRA63C 

PRBMMO 

pR|aoT 

PRSqUA 

PRIK^^ 


LNCHIO 
L SPAT A 

saTeo? 

HaTROT 

MCBlPZ 

HEASl 

MHoE 

hmogn 

SeTJ 

RKOO 

mooelI 

M0^41T^ 

MOVER 

mult 

navesu 

NAVI 


NRCITI 

OHPDaT 

88ISE? 

OUT PR C 

PARAtS 

PCTO 

phScg 

PHSjnT 

PUTINT 

PmaTRX 

PRAABC 

prbhhd 

INTEGR 

PSbHMD 


mmi 

ttN/07/7A 

nmilt 

07/08/74 
08/07/ 76 

08/ os/ 76 

umit 

08/12/76 

08/12/76 

07/08/76 

0R/p7/7S 

Og/* J/i* 
08/12/76 
q8/|2/76 

immi 

01/09/76 

07/08/76 

08/12/76 

06/02/76 

08/12/76 

09/05/75 

OB/12/76 

08/12/76 

Q7/Q8/7S 

□8/12/76 

07/08/76 

08/12/76 

07/08/76 

1%'Mm 

09/05/75 


4{|?1 is 

16l2aiH2 

i3Ti5lQ7 

21 1 1 3 5 So 
oeJsvStt? 

1 6 S 38 5 27 
13Mg:23 

2U 1 3 : 00 

13SN0J 37 
IN 109:23 
21 113101 
21113:01 
2 1113 10 1 
08 1 52 1 5N 
1811 1 i 16 
<1 1 13 10 1 
2i:i3ioi 
211 13102 
tOSONllN 
21 11 31 02 
09157 1 39 
08158119 
21 113103 
151511 57 
21 ! 13103 
08159132 
21 1 13103 


oS/IZ/76 

05/05/76 

ii'Ahn 

08/12/76 

irAim 

Q9/DS/7S 

02/2u/76 

07/08/76 

07/08/76 

06/12/76 

06/02/76 

o8/12/76 

O 9 /O 5/75 

09/09/75 

08/12/76 

O 9 /Q 5/75 

09/05/75 


13J27 
16120 
Q910R 
21 1 13 
21 1 13 
13127 
21:13 
21113 
21113 
21 ;13 
q 8;57 
o91 12 

oiiis^ 

1)6158 

21113 

18123 


FREAP 

F5WDE 

§!586^ 

gMtime 

qRaviy. 

HEAD 

HPIC^ 

hTrate 

impact 

INIT3 

IMTEGI 

INTE6R 

1NTEG6 

iNTgia 

InTQ13 

INVERT 

iVRSTi 

JUMP 

XXL PC 

LINECT 

LlNxI 

LNCHI 

LOaO^ 

H AENG 1 
matrix 

HAXQ 

mCPISP 

HHOALi 

MHOGE 

mhpgo 

MHDL 

HMDS 

MONITR 

MOVEir 

mtrxhp 

hTrIAH 

NAVeV? 

NAVMON 

nINTR* 

obsint 

ONSTEP 

orient 

0UT31 

PCHP^n 

PERTSi 

phsexc 

PHSPln 

pltsgm 

PDSiT 
pR A 6 3 H 
PREAOK 
PREIGM 
PRHEAD 

PRTIHE 

pSERSf 



imm 

03/02/76 

08/12/76 

09/05/75 

09/20/76 

07/30/76 

OB/12/76 

liJol/li 

08/12/76 
08/12/76 
08/ I 2/76 
06/12/76 

U'Ami 

1 1/05/ 75 

08/12/76 

08/12/76 

□7/08/76 

06/12/76 

01/09/76 

08/12/76 

08/12/76 

08/12/76 

08/12/76 

08/12/76 

08/12/76 

08/12/76 

08/12/76 

06/02/76 

09/07/76 

OB/12/76 

08/12/76 

08/12/76 

08/05/76 

□8/12/76 

11/05/75 

g 8/12/76 
7/15/76 
08/12/76 
07/08/76 
08/12/76 
07/08/76 
07/08/76 

liAl'At 

QB/ 12/76 
09/09/75 
06/12/76 
07/B8/76 
01/09/76 
09/05/75 



I 


nlui 


ToffiLI 


iNTtGR 

P«EISH 


uuEXlT 

RaNGEP 


rcSent 

R0ER31 

re&imu 

RE^ET 

rIDmap 

RKG2 


rqToeR 


roT res 

RARc 


SpbUOT 

search 

SEPo 

IfSlr 

SuOShI 

SNAVO 

iftfg' 

store 

STPqVr 

SUMP 

taSlep 

Ta|h 

TDErI 

teRmin 

teRmx 

tImEpH 
TIHerU 
T I Mesh 


RaNGEP 

RCSEWT 

K0Er31 

RED I MU 

CLOCK 

RIOMAP 

IRTEGR 

irtegr 

RrDUT 

Ph5»PLN 

KOToeR 

I(«TE 6 r 

RANC 

So&COT 

search 

SEPO 

SePI 

iiSiJi 

SNaVO 

SpGpRT 

STGIO 

STORE 

STPOVR 

SUMf 

TaBLEP 

Taeh 

TOERl 

1 £ R M I N 

TeRMX 

Tl 


Timers 

timers 


toPblk 

Tps 

TRJBLK 

TKNqeR 

Trnrsi 

UNIT 




VELOC 

vprint 

UflA73C 


VrA73C 

VSIPRT 


write* 

KUToPS 


T I hers 
title 
T OPBLK 
T pS 

tracer 
HaThSB 
Tr jbLK 
TRMoER 

J N T E G R 

UMIT 

UPOaTE 

vECfaLK 

VELOC 

VPRlNT 

VRA73C 

VSIPRT 

write* 

*uT(iPS 


09/09/7& 
09/Q5/75 
03/1 1/7& 

08 / j 2/76 

Oa/ I 2/7A 


IBj iOl**7 

nP! lOfnci 


oa/ 1 Z/7A 
OR/26/73 
0S/Q7/76 
O 9 /O 9 / 7 S 
Q9/Q9/7S 
-S/12/76 

□9/09/7S 

U'Aim 

09/07/76 

08/12/76 

08/I2/7S 

OS/12/76 

irAlAt 

06/12/76 

trAlAt 

06/02/76 

09/n9/7S 

07/06/76 

08/12/76 

09/05/75 

06/02/76 

06/02/76 

01/09/76 

II/05/7S 


09U9 
09US 
2IJI3 
2 I ! i 3 
21 I 13 
21113 
06 ; 1 9 
I9I3S 
iBi In 
16 ; In 
21113 




09126 
|6; 10 
21:13 
21 il3 
I6ib7 
21113 


21113 
21113 
21 1 l3 
21113 
21113 

lilil 

19130 
18119 
09;ti6 
21113 
□ 9139 


1 9l3e 1 

i9i3| I 

rv a • JL c • 


WAVAl 


11/05/75 

07/30/76 

of 

01 /Q9/76 


WAVAt 

09/09/75 

09/09/75 

iVArAl 

01/09/76 


0 9 • & 5 
11120 
1 1 ;20 

1 t 120 

DS 19 S 
21113 
09 1 07 
101G9 
09132 
19:31 
1 B 1 1 9 
iBllo 


09197 

09108 

19113 


q6/?|^ 
qB/| 2/?6 

iVAl'/U 

05/19/76 


09156 

21113 
21 1 13 


O 9 IO 9 

09153 


13156 


PSrAtM 

PYRaNw 

radar 

rangf 

RCSINT 
rEAO 1 1 
RELATv 
RGBS 
rkgi 

RKG3 

RNOOaT 

rneerr 

rotblk 

ROTMaT 


RQTR3I 

R*AAP 


RXAAP 

SOftl ve 

SErOE 

SEPOl 

SETJ 

SLOSH 

SL05RS 

snav J 

steer 

STIME 

storit 

SOBuSi 

TA 

TABPRi 

tapeno 

TDEr31 

TERMPT 

tguess 

timepf 

TIMERS 

timesf 

T IMESM 

}h?8gf 

TPSrtR 

tracer 

trim 

TRUCAL 

trnres 

TRmr31 

UNVEC 

VaRMaS 

vECmG 

vplot 

VRa71 
VRA73h 
WAIT 30 
*OATb 
2ERU1 ( 





18110 

09198 
21113 

09199 
1 6 I 99 
21113 
21 1 13 

09*09 

21113 

15151 







.T o Of 

t*Tt,RN/it.S otFl 




TiOmS 


. *S 


tn 

I 

KO 

ro 


FMAl^® 

AtlDLL 
ARObLK 
«ROC«L 
AKDLOK 
AR03t,6 
ARTAn 
A% i(sH 
■ aTHOS 
ATHOSl 
AVELUC 
0O*2r 
atOA 
»HTRX1 

EA^Sdl} 

clock 

CHATKX 

.£SSS?“ 

OAP3q 

onUhp 

001 

OTC^LC 

0TCH£K 

OTPotS 

OVNAMC 

OVNTtC 

EClALN 

EFNAME 

ENIiDOT 

ENjiO 

flZeko 

FRAME 

FREAO 

FSrtOE 

6 E 00 

GEIOAT 

GIHBAL 

6HT iHE 

GRl£«P 

6KAVTV 

HEAD 

H1RATE 

imiAL 

IHlEGf 

IHTGI 1 


NO, 

R£F§< 


I 

I 

I 

7 

H 

7 

I 

I 

1 

I 

1 

S 

I 


63 

H 

7 

7S 

Z 

I 

»! 

A 

a 

I 

I 

1 

1 

HZb 

2 

t 

1 

2 
H 
7 
6 
4 
2 
I 
Z 
I 


TgUt 
SUPS 
»Ot|l ^ 
>DQOO 

ml 

QOOl 
noi5 
001 '* 
009? 
0001 
8163 
0Q2I 
0000 
QQQ2 
0000 
OQOS 
0813 
QnQ£ 

loiS 

017b 
0&78 
00 »? 
0003 
Q0b6 
□ 01& 
0003 
onnz 
ovn 

0276 
DCOO 
ORDO 
QOI I 
0000 
0169 
0003 
0008 
S9V2 
3002 

QOOb 
0003 
005| 
0002 
0092 
0020 
0683 
0037 
OOQ3 
0501 
0213 


^’'tr.e^LwctO^O' unj 
* IN Name uR iron 5 
ALL iiheS in 4)Up Seconds 




MAX SUPS 
any RU'. 

• 0013 

• 0050 

• O0«fl 

• QC&6 

• 00t>4 

• Q0D2 

• Q0b3 

• 8164 

• 0006 

• OobO 

• 0002 
... •0000 

• 0006 

• OQOO 

• 08b? 
•| 6|8 

• 6003 

• 0176 

• 0021 

• 0003 

• 0002 
■ 0021 

• 00C2 

• 00(i9 

• opoz 

• 0914 

• 0273 
•0000 
■ OoOn 

• 0012 
• 0000 

... •016? 

• 0003 

• 0050 
•0167 

.•0002 

• 0005 
•00.03 
.0005 

• boot 

• 0001 

• 0007 

• 0178 

• 0023 

• 0003 

• 0501 

• 0214 


HIN 

any 


SUPS 

REF. 

0013 

0000 

B£Bf 

GOBI 
0DC.1 
OODO 
GOOD 
OCDO 
6464 
9001 ■ 
OQGO 
QGC2 
0000 
0006 
QOQt 
0802 

mt 

0176 

OGCO 

OGOO 

OGGO 

OGGI 

OOCO 

0003 

0001 

0?|4 

occo 
0000 
OGOO 
0GI2 
GOOD 
0169 
0003 
OQOO 
0056 . 
OODI 
0005 
0003 
OCOI 
0000 
0000 ' 
0002 
0169 
0015 
0003 

opoo 

0214 


toial 

LAU 
• DQ03 

>0o00 

S8SI 

Ooll 
0007 

oool 

egif 

OOQQ 

8002 


0C2 

0002 

O020 

0587 

Do29 

0003 

D0Q5 

0001 


Ll sS 


ToTae 

GC/ER 
•Ool 0 
*0000 

: B§eg 

• ddqo 

• odoq 

• nuQC 

• 0000 
• 0^00 


included 


Total 

I/O 

•QOUO 

• 0000 . 

•QpOO 
. 00(10 
oOOOO 
_ •0000 
• 0000 

• GOOD 

• 0000 


aVs, “ 

CAU 

• 0083 
_ •OOOO 

•oool 

• 0002 
•OUOI 
• 0002 
•oool 

• oool 

• 0090 


0001 

8002 

ill I 
0101 
0578 
00l9 
00D3 
0066 
9dI6 
0903 
0n02 
0720 
0096 

oqdq 

90DQ 

0002 

0090 

0113 

0003 

0000 
086a 
0002 
OOOb 

0001 


«Qt|62 


• nnnSi 

• OOOO 

• 1000 

f DUDJ 

•QOQD 

• 1000 

eODOQ 

•OOOO 

• nuQO 

•0002 

*0000 


* *PBtia 

• Onoo 


• 8006 

•8806 

• OOOO 

• 0002 

•8888 

- - 

• fiodo 



• 8082 
vllAl 

• 0102 

«9000 

• OQDl 

•0072 


•Dili . 

•0000 


• 0009 

®D100 

*QDtlO 

‘tlOOl 

* 0008 

• OOOO 

•oool 

•OOOO 

«aDQQ 

• 0009 

• GOOD 

«9DDD 

• 0000 

• OuQO 

*OOUO 

• 0013 


•0191 

•B07C 

• OOOC 

• oaoD 

• Do 1 0 
« 0000 

• Oo56 

• OOQD 
•0000 
*1260 

• 0000 

• Qnoo 

• 0no2 
•0000 

• Dooo 

•0.000 

• Qaoo 

• 80V6 

• oao8 

• 0000 
•0070 
•0070 


• 0000 

• 02 oo 

_ •0000 

• 0000 

• 0030 

• 0000 
*0000 

• 4000 
oQOOO 

2^0672 
.. •0000 

• 0000 
• 0000 
•0000 
,0000 
• 0000 
• 0000 

• OODO 
__.»0000 

• 0000 

• 0426 

• olio 


7 U f J « 

• 0720 

• 0010 
• 0000 
• 0000 
• 0002 
• 0000 
•0113 

• 0033 

• 0000 

• 0092 

• oool 

• 0015 

• oool 

• 0011 
•Ooou . 
•-0000 

• 0093 

• 0147 
. *0015 

• 0093 

• 0003 

•oool 


AVG, 
CC/ER 
• 00>8 
•DODQ- 

• QOQQ 
,0000 

• 0000 
*0000 

• OODO 
•0003 

• 0000 

• 8462 

• 0000 

• OOOO 

• 0000 

• dqoo.. 

• 0000 

• OODO 

• OOOO 

♦0716. 

• 0002 

• 0072 

• 0900 
•0000- 
•0000 

• OOOO 

• DODO 

• 0O0Q-. 

• 0000 

• 0194 
■ 0004 

.•0000_ 

• OOOO 

• OOlO 

• OOOO 
.-•0056 _ 

• OOOO 

• 0003 

• OolQ 
•OOOO . 

• OOOO 

• 0002 

• OOOO 
-.0000 . 

• 0090 

• OOOO 

• 0021 
.-•0004„ 

• OOOO 

• QD3S 

• D07q 


AVr,. 

I/O 

• OOOO 
—•ODOO_ 

• ogOQ 

• oDoa 

• DODO 

_»ocoo . 

• OOOO 

■ OODO 

• O0DEJ 

—•aooD- 

■ 0000 

• OODO 

• DODO 
_iOOCQ_ 

• OCOO 

• 0000 

• D08B 
—• 011 Z. 

■ OOOO 

• OSOO 

• 0000 
—• 0000 - 

• OCDO 

• DODD 

• OODO 
-•DODO„ 

• OODO 

• OODO 

• 0013 
-•DCDtt- 

• 0000 

• DOQO 

• OODO 
_» DDOD— 

• 0080 


• 1 

• 094^ 
..•OODO 

• OOOO 

• OOOO 

• OOOO 
•OCOD. 

• DOOO 

• OOOO 

• OOOO 
-•OODO- 

cOOQO 

• 0213 

• olio 


. t.-" 




*r^- ar . '^ r.* :r?iv'*jTi ■ 


l'±i^ .uc;.- -f;* 


,'t, Jt- V 




t> ws(k*^ 




, 


cn 

i 

V£) 


ACL Times (n sup scconos 


ClUOEO 


E*T. 

name 

invert 

JUMP 

KKLOC 

LINECT 

LINEUP 

lluao 

LOAD 

LOAOIT 

HAlRot 

MMDE 

HHUl 

HOUELI 

MONITS 

HOVilT 

MOVER 

MIRRMP 

HULT 

NAVRUN 

NINTrS 

OnSTLP 

orient 

OUTPRC 

PARaLB 

Pdu 

PhSEKC 

PhSINT 

phspln 

PHATRX 

POSIT 

prheao 

PRINT 

•PRTihe 

PSERS 

PftfclGH 

PTHAija 

REAOIT 

RESET 

RXb* 

RKIj 2 

RKQ3 

RKG*» 

KNOOaT 

ruimat 

Ilf 3 “ 

SNAVO 

ST£E« 

STIHE 

sTase 


^0. 

fiEF S » 

i 

370 

U 

7S 

70 

4 

16 

1 

H 

H 

? 

37 

5 

2 

1 

2 
1 
2 

eoB 

s 

J 

i 

H 

H 

1 

2 

1 
1 

21 
. n 

R 

H 

2 
2 
I 
1 
I 

1 

6 
IN 

2 
1 
2 
2 

ns 


total 

supS 


0000 

0031 

007 B 

0033 

0019 

0036 

32Hp 

coofl 
Opo 2 
OVdl 
0031 
0000 
DOOt 
0000 
0003 
0097 
DROS 
DOOS 
0002 
nOOQ 
OCgl 
0093 
0023 
0012 
07 l I 
DOOM 
nno3 
ooos 

0033 

GpSO 

0 R |6 

0200 

OORB 

Oq 02 
00Q3 
1 1 iO 
0009 
0002 
0303 
Cool 

OQOl 
CQOQ 
onod 
oni I 
0000 
0000 
0002 
DOQl 
OORR 


Max 

any 


SOPS 

HIN SUPS 

Tol AL 

klt • 

any REl* 

CAU 

OOOO 

• 000(1 

• Oooo 

0001 

• OOOO 

• DOOl 

DOUR 

• oood 

• 0078 

0002 

• QOOO 

• 0003 

0003 

• QQOO 

• 0019 

OOOR 

• 0003 

•Oq 3 o . 

32 R t 

* 32 R| 

• 0133 

00 C 2 

• QCDO 

• odob 

H 094 

• 0000 

• 0002 

09/7 

. *0000 

_ .0011 „ 

ODDI 

• OOOO 

>0001 

D 3 U 3 

• ORCO 

• Dodd 

0031 

• 9000 

> 000 l 

ODOO 

• qqOd 

• onoo 

0032 

• 0000 

*0003 

0007 

• 0001 

• 0097 

0 OU 2 

•OCOI 

• 0 OC 6 

0036 

• 0002 

.0006 „ 

0032 

• 0 C 02 

• OflCO 

0030 

• OODO 

• OoDO 

OOUl 

•ODOI 

• 0001 

0090 

... *0003 

.. . » OOBS „ 

0033 

• QOOO 

• 0023 

0033 

0/12 

• 0003 

• C/i 2 

• 0003 

• 0002 

Dour 

• OOOR 

. . .0004 „ 

0002 

*0000 

• OOC 3 

D 03 R 

• QOOO 

• OoOS 

0633 

• 0003 

• 0003 

0 D .>5 

• 0034 

.. *0036 . 

Q 2 B 7 

•Ql 3 o 

• 03 S 2 

023 B 

• 020 B 

• 0160 

0037 

• 0001 

• OORB 

ODUl 

•OOOO 

. •0002 _ 

DOCI 

• 0001 

• 0003 

OBRB 

•0006 

• Q 20 R 

0036 

•OOOR 

• D 0 Q 3 

0032 

• DUOl 

• 0002 

0633 

• 0003 

• Dn 03 

ODUl 

• 0001 

• onoi 

0031 

• OCOI 

• 0001 

003 n 

• OORQ 

• onoo 

00^3 

• Qono 

• onob 

OOU 3 

• ocoo 

• Doll 

0030 

• oooo 

• COOD 

0003 

• ooOo 

• DoOD 

0002 

•oooo 

• DQD 2 

60 UI 

• OoOD 

• 0001 

HOUR 

• OBQO 

• OORR 


ToTal 

CC/ER 


TOl aL 
I/O 


aVS# 

CAU 
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APPENDIX A 

EXEC 8 STANDARD UNIT OF PTOCESSING 
CHARGES AT NASA/ JSC 

A.1 APPLICATION 

This appendix covers the technique used by EXEC 8 at NASA/JSC for maintaining 

t 

Standard Unit of Processing charges for an application program. The accu- 
mulation of these charges Is the basis for charging application programs for 
the computer resources needed during their execution. The data presented 
in this appendix is EXEC 8 installation dependent. 

A.2 DEFINITIONS 

SUP Standard Unit of Processing, a unit devised to provide a consistent 
measure of computer service as viewed by an application program 
running under EXEC 8. 

PCT Program Control Table, a table maintained by EXEC 8 and containing 
control information about a specific .lob running under EXEC 8. 

CAU Control /Arithmetic Unit, the UNIVAC hardware equivalent to a 
Central Processing Unit (CPU). 

ER/CC Executive Request/Control Card, a designation for a computer 

service which the operating system performs for the user directly 
at his request. 

I/O Input/Output, a computer service in which data is moved between 
primary storage and a peripheral device. 

A. 3 GENERAL DESCRIPTION 

An application program running under EXEC 8 may accrue computer service 
charges in any or all of three categories which are charges for CAU, charges 
for ER/CC, and charges for I/O. The charges in each category are expre:sed 
in a common unit called a SUP second. EXEC 8 maintains the SUP charges 
accrued for a job in the job's PCT, which the job may reference but not 
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change. A user job may reference hts PCX by perfoming an executive request 
to the EXEC 8 entry point PGT$, or by basing the PCX as a read-only D-BANK 
by means of the LDJ instruction, both of which are documented in U. P, 4144, 
Revision 3. Xhe total SUP charges for a job are calculated by independently 
determining the charges for each of CAU, ER/CC, and I/O and then adding the 
three charge values together. Xhe CAU time is determined differently on 
1108 and IITO hardware but the ER/CC and I/O times are determined in the same 
v«y on both the 1108 and 111 0. 

A.4 CAU XIME ON UNI VAC 1110 

When configured on UNIVAC 1110 hardware, EXEC 8 maintains a storage reference 
counter for primary storage in PCX location 118 and for extended storage in 
PCX location 119. Xhe SUP time is calculated from these counters as indicated 
by the following equation. 


= tSp + S^) * 7/3200 

where 

XcAu “ SUP charge for CAU in 200 microsecond increments 
Sp = Primary storage reference counter from PCX cell 118 
Sg “ Extended storage reference counter from PCX cell 119 

A.5 CAU XIME ON UNIVAC 1108 

When configured on UNIVAC 1108 hardware, EXEC 8 maintains CAU time in cell 
22 of the PCX. Xhe time value in this cell is the SUP charge for CAU in 
100-microsecond increments. Xhe SUP time is calculated from the following 
equation. 



%U 


P,/2 
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where 


'CAU 




Slip charge for CAO in 200-mfcrDsecond increments 
The SUP charge value from PCI cell 22 




A. 6 ER/CC TIME 

on both the 1108 and IITO^ EXEG 8 maintains, the ER/K time in cell 134 of 
the PCT. The time value in this cell is the SUP charge for ER/CC in 200- 
microsecond increments, and the SUP time is simply calculated from the 
following equation, 

= E. 


where 

^ER/CC ” charge for ER/CC in 200-microsecond increments 
E.J. = The SUP Charge value from PCT cell 134 

A. 7 I/O TIME ■ ■ 

On both the 1108 and 1110, EXEC 8 maintains I/O charges in an identical 
fashion in the PCT. The I/O time Is maintained in cells 124 through 133 
of the PCT in 10 device group reference counter cells, and the time charges 
for each device group is the product of the device group counter and a group 
rate factor as indicated in the following equation. 


DT^. = lOGj * GP. 


where 

DT^ 

lOGj 


= Device group SUP charges in 100-nanosecond increments for 
1=1, TO 

= The device group factor from the PCT, where j varies from PCT 
cell 124 to 133 
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6Fi = The device group rats factor, for i=T, 10. This factor is 
defined i a the foTl^ 


• . 

1 

Factor 

Description 

1 

22 

Transfer rate for extended storage 

2f-- 

• 82 ■■ ^ 

Transfer rate for 432 drum 

3 

82 

Transfer rate for 1782 drum 

4 

229 

Transfer rate for 8440 disk 

5 • 

140 

Transfer rate for 8414 disk 

6 

200 

Transfer rate for U16C tape drive 

7 

229 

Transfer rate for 8460 disk 

8 

625 

Transfer rate for U8C tape drive 

9 

700 

Transfer rate for U12C tape drive 

10 

3000 

Transfer rate for all other devices 


The transfer rates for each factor are. in 1 00-nanosecond increments, 
total I/O time is calculated, from the following, equation. 



where 


The 


Tj/o “ SUP charges for I/O in 200-microsecond increments 
DT;| = Device gropp SUP charges in 100-nanosecond increments 

A.8 TOTAL SUP CHARGES • 

The* total SUP charges for a job may be calculated by the following equation. 

^SUP * ^CAU ^ER/CC ^I/O 
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^SUP 

’’’CAU 

'''er/cc 

Tl/0 


= Total SUP charges in 200-microsecond increments 
= Total CAU SUP charges in 200-microsecond increments 
= Total ER/CC SUP charges in 200-microsecond increments 
= Total I/O SUP charges in 200-microsecond increments 
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TEST CASE ELEMENT FORMAT 


B.l APPLICATION 

This appendix covers the content and format of the test case usage source 
element as created by the Code Usage Analysis System (CUAS) postprocessor. 

The element Includes the names of subroutine elements called and not called 
for the execution of a specific set of test case data by an application 
program. 

B.2 GENERAL DESCRIPTION 

The test case element is created as a source element in a UNI VAC program 
file with the UNIVAC program file maintenance package SOR utilized to generate 
the element. The element is created in the internal file name 'DBF' with 
the element name assigned by the user and the version name of ^TESTCASE*. 

The first record in the element is the text "SUBROUTINES USED BY TEST CASE 
XXXXXXXX' where XXXXXX represents the element name supplied by the user. The 
next n records of the element each contain the name, date, and time of crea- 
tion of a subroutine element used by the test case, n is the number of 

subroutines used. Following the n records of subrout, - . u . i a record 
with the character '*' in positions 1-36 and then a recoru mcn the text 
•SUBROUTINES NOT USED BY TEST CASE XXXXXXXX' where XXXXXXXX represents the 
element name supplied by the user. The next j records of the element each 
contain the name, date, and time of creation of a subroutine element not used 
by the test case where j is the number of subroutines not used. Following 
the j records of subroutines not used is a record with the character **' in 
positions 1-36. The format of the test case element is depicted in figure 
B-1. 


Record 

no, 

1 

2 

3 


Description 

SUBROUTINE USED BY TEST CASE XXXXXXXX 
SUBNAM T MM/DD/YY HH?MM;SS 

SUBNAM 2 MM/DD/YY HH:MM;SS 


n 

n+1 

n+2 

n+3 

n+4 


SUBNAMN MM/DD/YY HH:MM;SS 

SUBROUTINES NOT USED BY TEST CASE XXXXXXXX 
SUBNAM! MM/DD/YY HH:MM:SS 

SUBNAM2 MM/DD/YY HH:MM:SS 


n+j 

n+j+1 


SUBNAMJ MM/DD/YY HH:MM:SS 

it^*kic’k’kicici(icirk‘kiffe^ie*k'kit’k'kic 36 ^ 


where 



XXXXXXXX 


~ User-su 

MM 


- Month 

DO 


= Day 

YY 


= Year 

HH 

*■ 

= Hours 

MM 


- Minutes 

SS 


* Seconds 


Figure B-1.- Test case element format. 
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APPENDIX C 


UNIVAC EXEC 8 ABSOLUTE ELEMENTS 

This appendix covers the format of an absolute element as produced by the 
UNIVAC 1100 series Memory Allocation Processor (HAP), level 24 or later, 
and is compatible only with EXEC 8 level 30 or later. The format presented 
is that of an absolute element in an EXEC 8 program file as placed there by 
the UNIVAC MAP. The presentation assumes a general knowledge of the func- 
tion and use of the UNIVAC MAP and EXEC 8 program files as presented in 
UNIVAC Publication 4144, Revision 3. The remainder of this appendix is a 
presentation of the format of an absolute element as it is produced on the 
EXEC 8 systems in use at NASA/ JSC as of this writing. 
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APPENDIX D 


CODE USAGE ANALYSIS SYSTEM JUMP HISTORY STACK FILE 


D.l APPLICATION 

This appendix covers the content and format of the Jump History Stack File 
(JHSF) as created by the Code Usage Analysis System (CUAS) contingency sub- 
routine IICONT. This file is used as a data input file by the CUAS postproc- 
essor program in order to produce reports concerning the execution character- 
istics of an application program executed under the UNIVAC EXEC 8 operating 
system. 


D.2 DEFINITIONS 


CAU Control /Arithmetic Unit, the UNIVAC hardware equiva- 

lent to a Central Processing Unit (CPU) 

CELL 36 binary digits treated as a unit of primary storage 

and directly addressable by the CPU as a unit 

CUAS Code Usage Analysis System 

ER/CC Executive Request/Control Card, a designation for a 

computer service which the operating system performs 
for the user directly at his request 

HI The most significant 18 bits of a cell, or bits 18-35 

of the cell 

H2 The least significant 18 bits of a cell, or bits 0-17 

of the cell 

I/O Input/Output, a computer service in which data is 

moved between primary storage and a peripheral device 

0 A mnemonic for a valid UNIVAC-llOO processor instruc- 

tion which transfers control to a specified address 

JHSF Jump History Stack File 

LMJ A mmemonic for a valid UNIVAC-llOO processor instruc- 

tion which saves the current value of the P register 
and transfers control to a specific address 
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(nnrmnn)o The representation used for an octal natural number, 

° that is, a number whose base is 8 

Q1 The most significant 9 bits of HI of a cell, or bits 

27-35 of the cell 


Q2 


The least significant 9 bits of HI of a cell, or bits 
18-26 of the cell 


Q3 


The most significant 9 bits of H2 of a cell, or bits 
9-17 of the cell 


Q4 The least significant 9 bits of H2 of a cell or bits 

0-8 of the cell 

SUP Standard Unit of Processing, a unit devised to provide 

a consistent measure of computer service as viewed by 
an application program running under EXEC 8 


D.3 GENERAL DESCRIPTION 


The Jump History Stack File (JHSF) is created as a UNI VAC EXEC 8 FASTRAND 
formatted mass storage file on a secondary storage device, A FASTRAND 
formatted file is one which is addressable by units of 28 cells which are 
defined as sectors. Such a file may be accessed by a basic I/O executive 
request, which is documented in UNI VAC Publication 4144, Revision 3, Chapter 
6 or by the FORTRAN I/O routine NTRAN, which is documented in UNIVAC Publi- 
cation 7876, Section 4.18. 


D.4 JUMP HISTORY STACK FILE DESCRIPTION 

The JHSF may be viewed as simply a sequential string of 36-bit cells occupy- 
ing as many sequential and contiguous sectors as are required to contain the 
string. With the exception of the first seven cells of the string, each of 
the cells contains data indicating the occurrence of some event during the 
execution of an application program, and the sequence of the cells in the 
file indicates the sequence of event occurrence. The first seven cells of 
the file contain the following data: 
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Cell 1 - The first six fi el data characters of the absolute element name which 
when executed created this file 

Cell 2 - The last six fieldata characters of the absolute element name 

Cell 3 - The first six fieldata characters of the version name of the abso- 

lute element 

Cell 4 - The last six fieldate characters of the version name 

Cell 5 - The date and time of creation of the absolute element, formatted 

exactly as it appears in a program file 

Cell 6 - The @XQT options present on the CUAS preprocessor execute card when 
the absolute element was modified. The options are represented in 
master bit notation, that is, bit 0 on for Z and bit 25 on for A 

Cell 7 - The total number of sectors written in the JHSF, a 36-bit binary 
integer 


Beginning with cell 8 of the file, each cell contains a sentinel in bits 34 
and 35 which indicates the type of data represented by the remaining bits 
0-33 of the cell. The two-bit sentinel is defined as follows: 


Sentinel 

binary value Description 

00 The lov/er 16 bits of HI of the cell contain the address of 
an LMJ instruction which was executed. H2 of the cell 
contains the address to which the LMJ instruction trans- 
ferred control 

01 The lower 16 bits of HI of the cell contain the address of 
a J instruction which v/as executed. H2 of the cell con- 
tains the address to which the J instruction transferred 
control 

10 Bits 0-33 of the cell contain a SUP time value 

11 HI of the cell contains a sentinel indicating the occur- 
rence of an error event and H2 of the cell contains the 
description of the event 
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D.4.1 SUP TIME CELL INTERPRETATION 


SUP time value cells (sentinel 10) are included In the JHSF only when option 
C was specified to the CUAS preprocessor, which may be determined by inspec- 
tion of cell 6 of the JHSF, When this option is specified, each LMJ event 
cell (sentinel 00) and J event cell (sentinel 01) is followed by three SUP 
time cells. The three cells contain the amount of CAU, ER/CC, and I/O time, 
repectively, v/hich was used since the last such occurrence in the JHSF of an 
LMJ or 0 cell followed by the three time cells. The CAU time is in micro- 
second increments, and the ER/CC and the I/O times are in 200-microsecond 
increments. 


0-4.2 ERROR EVENT CELL INTERPRETATION 

Error event cells (sentinel 11) are included in the JHSF for the indication 
of program errors, segment loads, and end of file. The total value of HI of 
an error event cell indicates the event type, defined as follows; 


HI octal value 
(777777)g 


(777776)g 


Description 

If H2 of the cell is also ( 777777 )g, this cell indicates 
the end of the file. If not, this°is a segment load 
sentinel with Q4 of the cell containing the index of the 
segment loaded and Q3 of the cell containing the index 
of the segment loaded just prior to it. 

A guard mode sentinel with the address at which the 
guard mode occurred in H2 of the cell. 


(777775)„ An arithmetic overflow sentinel with the address at which 

° the overflow occurred in HZ of the cell. 


(777774)n An arithmetic underflow sentinel with the address at 

° which the overflow occurred in H2 of the cell. 


(777773)g 


An arithmetic divide fault sentinel with the address at 
which the divide fault occurred in H2 of the cell. 


(777772)- An ER AB0RT$ sentinel, that is, the user did an execu- 

° tive request to AB0RT$ to terminate his program execu- 

tion. The address at which the request was made is con- 
tained in H2 of the cell. 
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HI octal value 


Description 

{777771 )_ An ERROR MODE sentinel with the address at which the 

“ program was placed in error mode contained in H2 of the 

cell. 

D.5 USE OF THE JHS F 

The JHSF represents both events that occurred during a program execution and 
the sequence in which those events occurred. The amount of detail included 
in the file is determined by the way the subroutine IICONT is initialized. 
This initialization is normally performed by the CUAS preprocessor and is 
controlled by the user with execution options. J instruction and SUP time 
event cells are included in the JHSF only if option C was specified to the 
CUAS preprocessor. LMJ instruction cells are included in the JHSF unless 
option B was specified to the CUAS preprocessor. Error event cells are 
always included in the JHSF. A scan, normally done by the CUAS postprocessor 
to produce reports, allow determination of the execution path and character- 
istics of a program. 

The JHSF is intended to be used in conjunction with the diagnostic tables 
from an absolute element as prepared by the UNIVAC MAP under EXEC 8. The 
content and format of an absolute element is described in Appendix C. The 
format of the JHSF is depicted in figure D-1. 
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ABSOLUTE ELEMENT 
NAME 


ABSOLUTE ELEMENT 
VERSION NAME 


DATE/TIME OF ABSOLUTE 
ELEMENT CREATION 


CUAS PREPROCESSOR 
@XQT OPTIONS 

TOTAL NUMBER”1f1eCTOF« 
S, IN FILE 


j FIRST EVENT DESCRIPTOR CELL 


j SECOND EVENT DESCRIPTOR CELL 


777777 


777777 I 

i 


I LAST EVENT DESCRIPTOR CELL. 
I (E.O.F. SENTINEL) 


Figure 0-1.- Jump history stack file. 





,• APPENDIX E 

TEST CASE USAGE REPORTING SYSTEM 
El. INTRODUCTION 

This document provides information related to the operation &nd use of the 
Test Case Usage Reporting System (TCURS). Descriptions of the system capa- 
bilities, method of operation, and user’s information are included. 

The TCURS is intended to aid the user in detennining those subroutines used 
and not used within a program file from which several different absolute 
elements may be generated. Cross-reference reports are provided from which 
the user may determine for any specific absolute element those subroutines 
which were included in the absolute element and calleJ at least once; or 
conversely, for any specific routine, those absolute elements in which it 
was included but not called at least once. 
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U. TEST CASE USAGE REPORTING SYSTEM DESCRIPTION 


E2.1 SYSTEM CAPABILITIES 

The TCURS was designed to generate reports of all subroutines used by a set 
of test cases and consists of two separate programs, the File Relocatable 
Element Directory (FRED) program and the Test Case Report Generator (TCRGEN) 
progrcOT. 


The FRED program analyzes a user's program file directory and inserts into 
a Data Base File (DBF) an EXEC 8 System Data Fomat (SDF) source element con- 
taining the names of all the user relocatable elements. The TCRGEN program 
produces the cross-reference reports of subroutine usage by test case. The 
Code Usage Analysis System (CUAS) is used to generate elements containing the 
names of the subroutines used by each test case. 

Specifically, the FRED and TCRGEN programs provide the user the following 
information concerning the execution of his application programs. 

E2.1.1 MASTER ELEMENT DIRECTORY REPORT 

This report is generated when the FRED program is executed. The FRED program 
provides the user with a report containing the subroutine element names and 
version names, including creation date and time. 

E2.1.2 TEST CASE ELEMENT REPORT 

The test case element report which is generated by the TCRGEN program contains 
an alphabetized listing of all element names included in the master file 
directory. This is an exception report which is included to indicate to the 
user that the master file director is incomplete and should be updated. 

E2.1.3 TEST CASE USAGE REPORT 

The test case usage report, which is generated by the TCRGEN program, is dis- 
played in matrix-like form with an alphabetized listing of each test case 
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name, including creation date, and time, appearing horizontally at the top 
of the report page. The alphabetized element names Including version, crea- 
tion date, and time, are listed vertically on the left side of the report 
page. When an element was used by a particular test case, this is indicated 
by an “X" in the element name row and test case name column intersection. 

An asterisk is placed adjacent to and preceding the "X** to indicate that the 
master element directory time and date for the element does not coincide with 
the creation date and time for the element used by the test case. 

E2.1.4 ELEMENT USAGE REPORT 

The element usage report displays the test case usage by element name, alpha- 
betized on the left side of the page; opposite are the names of all test cases 
in which the element was incluujd and called at least once. 

E2.2 METHOD OF SOLUTION 

The TCURS maintains all test case and subroutine data as source el enents in 
a UNIVAC EXEC 8 program file. Standard UNIVAC software is used to create 
and read these data elements. The use of this technique for maintaining the 
data allows for the use of standard EXEC 8 control statements to maintain 
the file and inspect the contents. 

The following sections describe the reports generated by the FRED and TCRGEN 
programs. 

E2.2.1 MASTER ELEMENT DIRECTORY REPORT 

The master element directory report consists of a list of relocatable element 
names and version names, including creation date and time. The FRED program 
scans the user-specified EXEC 8 program file directory for relocatable element 
names and combines all such names and associated Information into a source 
element. This source element becomes the master file directory and is inser- 
ted into a file with the internal name DBF. The FRED program then prints the 
report under the appropriate heading information. 
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E2.2.2 TEST CASE ELEMENT REPORT 

The test case element repoirt consists of an alphabetical list of all element 
names Included in a test case but not Included in the master file directory. 
The master file- directory elements are obtained from the DBF. The test case 
elements are obtained from source elements created by the CUAS postprocessor, 
which are inserted into the DBF. The elements specified in the master file 
directory are sorted into alphabetical order and each element used by the 
test case and not included in the master file element directory is listed. 

The TCR6EN program then prints the report under the appropriate heading infor- 
mation. 

E2.2.3 TEST CASE USAGE REPORT 

The test case usage report consists of an alphabetized listing of each test 
case name, including creation date and time, appearing horizontally at the 
top of the report page. The alphabetized element names including version 
name, creation date, and time are listed vertically on the left side of the 
report page. The TCRGEN program scans the DBF directory for test case entries 
and sorts the names into alphabetical order. When an element was used by a 
particular test case, and the master element directory time and date are the 
same as those for the element used by the test case, this is indicated by an 
‘'X“ in the element name row and test case name column intersection. An as- 
terisk is placed adjacent to and preceding the “X" to Indicate that the 
master element directory time and date for the element is not the same as 
the creation date and time for the element used by the test case. 

E2.2.4 ELEMENT USAGE REPORT 

The element usage report consists of an alphabetized list of element names. 

For each element name, the names of all test cases which called the element 
are listed in alphabetical order. 

The test case usage report is prepared in the same manner as the test case 
element report except that the element usage report displays test case 

EEPBODUomE^rry of ti 
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usage with the element name on the left- side of the report page.,' The ele- 
ments and test case names are listed under the appropriate heading. 

The total operation for the FRED and TCRGEN programs is depicted in figure 1. 









E3. USER'S GUIDE 

E3.1 METHOD OF USE 

The FRED and TCRGEN absolute elements have been implemented on the UNI VAC 
1108, EXEC 8, processors 7 and '8, and may be accessed from the secure file 
FML-L79351*PHPA. The FRED program uses an internal file name, hereafter 
referred to as Relocatable Input (RIP), which is assigned to the user program 
file from which the master file directory is to be created. 

The user must provide EXEC 8 ©USE directives to indicate which file is to be 
scanned for relocatable elements (file RIP) and which file is to receive the 
source element created (file DBF). The TCRGEN program utilizes the master 
file directory created as d^^Jcribed above in the generation of the TCRGEN 
reports. The data for the subroutines used and not used by the test case is 
obtained from source elements created by the CUAS postprocessor. The test 
case elements created by the CUAS must be in the same file with internal 
name DBF, as the master file directory. The method of use of the CUAS for 
the creation of test case elements is described in the CUAS user's guide and 
will not be detailed here. Before executing the TCRGEN, the user must create 
in a common program file the master file directory using the FRED program and 
one or more test case elements using the CUAS. 

E3.1.1 RUN STREAM FOR THE FRED PROGRAM 


1. 

@RUN 

• * * 

2. 

©USE 

DBF., OUTPUT. 

3. 

@USE 

RIP., INPUT. 

4. 

@XQT 

FML-L79351*PHPA.FRED 

5. 

©FIN 



1. Required statement to initiate run on EXEC 8, 

2. Assign internal name DBF to OUTPUT. 

3. Assign internal name RIP to INPUT. 


' 4 -.. 




4. The FRED program is executed to analyze tf^e progr:*n file directory and 
insert into the DBF an element containing the name of all the user re- 
locatable elements. 

5. Required statement to end run on EXEC 8. 

E.3,1.2 RUN STREAM FOR THE TCR6EN PROGRAM . 

1. @RUN ... 

2. @USE DBF., USER FILE 

3. eXQT FML-L79351*PHPA.TCRGEN 

4. @FIN 

1. Required statement to initiate run on EXEC 8. 

2. Assign internal name DBF to the SVDSTCL file. DBF must contain the user 
master file directory and the test case elements. 

3. The TCRGEN program to produce the reports. 

4. Required statement to end run on EXEC 8. 

See the CUAS user's guide for a sample CUAS run stream. 

E3.2 OUTPUT DESCRIPTION 

E3.2.1 NORMAL OUTPUT FOR THE FRED PROGRAM 

Normal output for the FRED program consists of one basic display-: 

1. This report is initiated by the heading, "MASTER ELEMENT DIRECTORY 

CREATION PROGRAM." The following information is printed for each element. 

• El ement name 

• Version name 
e Creation date 

• Creation time 










E3.2.2 NORMAL OUTPUT FOR THE TCRGEN PROGRAM 

Normal output for the TCRGEN program consists of three basic displays: 

1. Test Case Element Name Report - This report is initiated by the heading, 
"TEST CASE USAGE REPORTING SYSTEM." The next line indicates a legend for 
the information to follow. 

I 

The following information is printed for each test case. 

0 Test case names in alphabetical order 

• Element names used by the test case but not listed in master file 
di rectory 

This report is displayed if the master file directory is incomplete and 
should be updated. 


2. Test Case Usage Report - This report is initiated by the heading, "TEST 
CASE USAGE REPORTING SYSTEM." The next line provides a legend for the 
asterisk. An asterisk is placed adjacent to and preceding the "X" to 
inform the user that the master element directory time and date for the 
element does not coincide with the creation date and time for the element 
used by the test case. The following information is printed for each 
element: 

» The test case names in alphabetical order, with creation date and 
time 

9 The element names including version name in alphabetical order, and 
creation date and time 

• When an element was used by a particular test case, this is indi- 
cated by an "X" in the element name row and test case name column 
intersection. The "X" is preceded by an asterisk under the conditions 
specified in the legend. 

3. Element Usage Report - This report is initiated by the heading, "ELEMENT" 
and "TEST CASE NAMES USING EACH ELEMENT." The following information is 
printed for each element: 




1 f 





'•! 


1 



.■'■f ■' 

; i 
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• The element names in alphabetical order . 

• The names of all test cases which called the element are listed in 
alphabetical order. An example of the FRED program report is shown in 
section E5.4.2. Examples of the TCRGEN reports are shown in section 
E5. 4. 4» 


E3.2.3 ERROR MESSAGES 

Error messages are provided in the TCURS to infomi the user of any condition 
that prohibits the normal operation of the system. There are two forms of 
error messages; the first form identifies and describes the error condition 
directly in the printed output, and the second form provides error numbers 
which are described in the following table. 


The error format is 

•ERR n ERROR' 

where n may take on values as follows: 

Diagnostic (n) 

Program 

Description 

1 

FRED 

Error indicates a FA3TRAND read error. I; 

This error condition is documented in 
Uni vac Publication 4144, Rev. 3. 

i 

2 

FRED 

The element table is empty; this error 
will terminate program execution 

3 

FRED 

I/O error on file RIP 

4 

FRED 

See diagnostic 1 

5 

FRED 

See diagnostic 1 

6 

FRED 

I/O error on file RIP 

7 

FRED 

I/O error on file RIP 

8 

FRED 

See diagnostic 1 

9 

TCRGEN 

The element table is empty; this error 
will terminate program execution 

10 

TCRGEN 

See diagnostic 1 

11 

TCRGEN 

ERTRAN read error. This error is docu- 


mented in Uni vac Publication 4144, Rev. 3. 
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E4. EXECUTION CHARACTERISTICS 


E4.I RESTRICTIONS 

The TCRGEN program has these limitations: 

1. The program is valid only if there exist a program file directory. 

2. The maximum number of test case names allowed is 50. 

3. The maximum number of relocatable eleir'nt names allowed in the master 
file directory is 700. 

E4.2 RUNNING TIME 

The run time for the TCRGEN program will vary depending on the size of the 
program file directory being evaluated. Approximately 2.18 minutes were 
required to evaluate the Space Vehicle Dynamics Simulation (SVDS) program 
file directory. The FRED program requires approximately 13.7 seconds to 
evaluate the SVDS program file. 

E4.3 ACCURACY/VALIDITY 

Validation of the FRED and TCRGEN programs has been accomplished primarily 
by the comparison of contents from the normal SVDS output and by desk checking 
the results of the SVDS reports. 



































E.5.2 FUNCTIONAL FLOWCHART OF THE TCRGEN PROGRAM 

Figure 3 illustrates the- flow of the main program (TCRGEN) logic. 
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CALL ERTRAN 



Figure 3.- Continued. 
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E5.3 SUBROUTINE DOCUMENTATION 

The JLALOC, KMPRES, and NMSORT subprograms, unique to the TOURS, are docu- 
mented on the following pages. 

Subprograms BD2FD, DISKIO, and ILLSFT, common to both the TOURS and the 
OUAS, are documented in section 5.5 of the OUAS cfocument. 


I 
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SUBROUTINE JLALOC 


IDENTIFICATION 

Name (Title) - JLALOC (Locate Word) 

Programmer, Date - J. D. Oliver, June 1976 

Machine Identification - UNI VAC 1100-Series 

Source Language - FORTRAN V 

PURPOSE 

Subroutine JLALOC locates the word and position within a word where the nth 
character of a string would be. 

USAGE 

• Calling Sequence 

CALL JLALOC (N, NW, NL) 

Arguments : 

Parameter 


name 

In/Out 

Dimension 

Jiee 

Description 

N 

In 

1 

I 

The character number 

NL 

Out 

1 

I 

The beginning bit con- 
taining this character 

NW 

Out 

1 

I 

The word containing 
this character 


METHOD 
• Model 

Subroutine JLALOC computes the word location and bit location of a string. 
In general, the bit location is computed using a mathematical intrinsic 
function. 
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The word location is given by: , 

NW = (N-D/6 + 1 

The bit location is given by: 

NL = M0D(N-i,6) * 6 


where 

N = The character number ■ 

NW = The word containing this character 

ML = The beginning bit containing this character. 
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FUNCTION KMPRES 


IDENTIFICATION 

Name (Title) - KMPRES (Compress Blanks) 

Programmer, Date - 0. D. Oliver, June 1976 

Machine Identification - UNIVAC llOO-Series 

Source Language - FORTRAN V 

PURPOSE 

Function KMPRES moves a substring from a string containing blanks to the 
array containing the compressed string. 


USAGE 

• Calling Sequence 

, J=KMPRES (A, I, N, B, J) 

i \ 

I / 


Arguments ; 





Parameter 

name 

In/Out 

Dimension 

Type 

Description 

A 

In 

1 

R 

The string containing 
blanks 

B 

Out 

1 

R 

The array to contain the 
compressed string 

I 

In 

1 

I 

The starting character in 
the string containing 
blanks 

J 

In 

1 

I 

The beginning character 
in the array to contain 
the compressed string 

N 

In 

1 

I 

The number of characters 
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METHOD 



• Model 

Starting with the beginning character, function KMPRES is set to the 
number of nonblank characters in a substring containing blanks to com 
press the characters of the array. 

RESTRICTIONS ^ 

0 Operational 

Subroutine JLALOC is required. 


} 

I 

i 


p 


i 

5 




1 

i 
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SUBROUTINE NMSORT 


IDENTIFICATION 


Name (Title) 
Programmer, Date 
Machine Identification 
Source Language 


NMSORT (Name Sorter) 

P. H, Horsley, August 1975 
UNIVAC 1100-Series 
FORTRAN V 





II 



I 




PURPOSE 

Subroutine NMSORT sorts an array of alphanumeric names into alphabetical 
order according to the collating sequence of fieldata characters on UNIVAC 
EXEC 8. 


USAGE 

e Calling Sequencw 

CALL NMSORT (NA‘ IX, NE) 

Arguments : 

Parameter 

Name In/Out Dimension Type 

NAM In Variable I 


NE In 1 I 


IX Out Variable 


NAM Out Variable I 


Description 

The array of fieldata names to 
be sorted. Each name occupies 
two contiguous cells in the 
array, or is 12 characters long 

The number of two-cell entries 
in array NAM, or half the length 
of the array NAM in cells 

Array of NE entries containing 
the index order of the original 
NAM array needed to place it in 
alphabetical order 

The array of fieldata names 
sorted into alphabetical order 
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• Error Messages 

None - if the parameter NE is less than or equal to 1, no sort is performed 
and a return is done, 

METHOD 

• Model 

The fieldata entries in the- parameter array NAM are considered as 72 bit, 
unsigned integers by subroutine NMSORT. A bubble sort technique is used 
to place the 72 bit unsigned integers into ascending numerical sequence 
which effectively results in an alphabetic sort based on the UNIVAC EXEC 8 
fieldata characters collating sequence. The parameter array IX is returned 
with the index position of each name in the array NAM on entry. For ex- 
ample, if name number 5 was moved to position 1 in the course of the sort, 
the first cell of IX would contain the number 5. 


E5.4 SAMPLE INPUT/OUTPUT 


E5.4.1 SAMPLE INPUT FOR THE FRED PROGRAM 

The job stream given below indicates the operations necessary to execute 
the FRED program. This sample input illustrates the application of the 
FRED program to the SVDS file directory. For a general description of the 
input, refer to the run stream description provided in section E3.1.1. 


©RUN ... 


@USE 

DBF. ,FML-L79351*SVDSTCL 

@USE 

RIP.,FM9*SVDS. 

@XQT 

FML-L79351WA.FRED 

0FIN 



E5.4.2 SAMPLE OUTPUT FOR THE FRED PROGRAM 

A portion of the printed output generated by the FRED program execution 
follows. 
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flKSTER ELEnENT OIRECTORV CREATtON RROGRAn 



ELEHENT 

VERSION 

CREATION 

CREATION 


NAHE 

NAME 

DATE 

TiriE 


LOSS 


09/05/75 

08:56:03 

2* 

PlATHFN 


09/05/75 

08:58:10 

3^ 

rtATOPS 


09/05/75 

08:58:28 


nftTROT 


09/05/75 

08:59:32 

5» 

niwv 


09/05/75 

09:00:93 

6¥ 

*nULT 


09/05/75 

09:09:36 

7* 

nULT3 


09/05/75 

09:09:39 

e« 

PUJLT9 


09/05/75 

09:09:93 


ns 091 


09/05/75 

09:09 :52 


none ON 


09/05/75 

09:05 :08 

n* 

ONEOn 


09/05/75 

09:10:12 

12« 

ORDER 


09/05/75 

09:10:55 

13^ 

ORESIK 


09/05/75 

09:11:03 

19^ 

0UT31 


09/05/75 

09:12:00 

15* 

PARftLB 


09/05/75 

09:12:18 

16* 

PHSANG 


09/05/75 

09:12:39 

17* 

PLP1509 


09/05/75 

09:13:50 

10* 

PHATCH 


09/05/75 

09:t3i59 

19* 

PRA63C 


09/05/75 

09:19:99 

20* 

PRA63H 


09/05/75 

09:15:10 

21* 

pRBnno 


09/05/75 

09:15:13 

22* 

PROCT 


09/05/75 

09:15:20 

23* 

PREGLT 


09/05/75 

09:15:27 

29* 

PRINT 


09/05/75 

09:16:12 

25* 

PROJCT 


09/05/75 

09:17:00 

26* 

PSBnno 


09/05/75 

09:19:03 

27* 

PWEIGH 


09/05/75 

09:19:08 

20* 

nfkWH 


09/05/75 

09:19:57 

29* 

RDER31 


09/05/75 

09:22:53 

30* 

RES 


09/05/75 

09:29:96 

31* 

RN2S 


09/05/75 

09:26:09 

32* 

RQTDER 


09/05/75 

09:26:38 

33* 

ROTPIftT 


09/05/75 

09:26:55 

39* 

RPNMAT 


09/05/75 

09:27 ;58 

35* 

RTWAIX 


09/05/75 

09:29:17 

36* 

RUNCIO 


09/05/75 

09:29:39 

37* 

SEARnT 


09/05/75 

09:31:56 

38* 

SKEta 


09/05/75 

09:33:20 

39* 

SLOSHl 


09/05/75 

09:33:37 

90* 

SPLNl 


09/05/75 

09:39:97 

91 * 

son 


09/05/75 

09:36:92 

92* 

TA 


09/05/75 

09:37:19 

9 3* 

TABLE 


09/05/75 

09:37:23 

99 * 

TAB509 


09/05/75 

09:37:59 

95* 

TOERt 


09/05/75 

09:39:29 

96* 

TDER2 


09/05/75 

09:39:37 

9T* 

T0ER31 


09/05/75 

09:39:58 

98* 

TlNORn 


09/05/75 

09:91:98 

99* 

TINTE6 


09/05/75 

09!9t;51 

50* 

TLAS 


09/05/75 

09:91:59 

51* 

TOPCON 


09/05/75 

09:92:52 



raster EI.EREAIT directory creation proqram 



ELEMENT 

version 

CREATION 

CREATION 


NOME 

NANE 

DATE 

TIME 

^2* 

TOPQOT 


09/05/75 

09:93;09 

5 3* 

TRIVOfl 


09/05/75 

09:95Ut> 


TVBEC 


09/05/75 

09t^7t30 

55¥ 

TWflSH 


09/05/75 

09:97sA6 

56» 

UNIT 


09/05/75 

09t97:50 

57* 

UNVEC 


09/05/75 

09:98:01 

53* 

VECMG 


09/05/75 

09:99:25 

59* 

VHCOPS 


09/05/75 

09:99:29 

*0* 

VRA73C 


09/05/75 

09:50:08 

61* 

VRA73K 


09/05/75 

09:50:16 

62* 

UIRITEX 


09/05/75 

09:53:25 

63* 

XL1I9TT 


09/05/75 

09:53:35 

69* 

XVZTOE 


09/05/75 

09:53:39 

65* 

ABINOt 


09/05/75 

18:22:52 

66* 

AN5UER 


09/05/75 

18:27:52 

67* 

ARCOS 


09/05/75 

18:28:36 

68* 

AROOOT 


-09/05/75 

18:29:01 

69* 

ARSIN 


09/05/75 

18:29:27 

70* 

ARTAN 


09/05/75 

18:29:31 

71* 

AVELOC 


09/05/75 

18:30:28 

72* 

AZTTftR 


09/05/75 

18:30:39 

73* 

90E79C 


09/05/75 

18:31:02 

79* 

6DE79H 


09/05/75 

18:31:08 

75* 

BOP63C 


09/05/75 

18:31:28 

76* 

BOP63H 


09/05/75 

13:31:39 

77* 

B0SP63 


09/05/75 

18:31:93 

78* 

B0530a 


09/05/75 

18:31 :59 

79* 

BDS30H 


09/05/75 

18:32:03 

80* 

BDS60C 


09/05/75 

18:32:11 

fll* 

BDS60H 


09/05/75 

16:32:20 

82* 

BDS62R 


09/05/75 

18:32:30 

83* 

8DV71R 


09/05/75 

18:32:37 

89* 

80V73C 


09/05/75 

18:32:92 

85* 

BOV73H 


09/05/75 

18:32:98 

86* 

BEND 


09/05/75 

18:33:38 

87* 

BENDA T 


09/05/75 

18:33:96 

80* 

BEND! 


09/05/75 

18:33:53 

89* 

BINTRP 


09/05/75 

18:39 :00 

90* 

BMATRX 


09/05/75 

18:39 :23 

91* 

BNDRES 


09/05/75 

18:39:52 

92* 

BNOVAL 


09/05/75 

18:35:07 

93* 

6PR0C 


09/05/75 

18:35:15 

99* 

CMDFIL 


09/05/75 

18:35:28 

95* 

DOE 


09/05/75 

18:35 :33 

96* 

COflELE 


09/05/75 

10:35:36 

97* 

CONTAC 


09/05/75 

18:36:39 

98* 

CROSS 


09/05/75 

18:37:06 

99* 

OAYZ 


09/05/75 

18:38:25 

100* 

OEPOHO 


09/05/75 

18:38:95 

101* 

DETPTB 


09/05/75 

18:38:99 

102* 

DOT 


09/05/75 

18:39:10 


E5.4.3 SAMPLE INPUT FOR THE TCRGEN PROGRAM 

The job stream given below indicates the operations necessary to execute 
the TCRGEN program. This sample input illustrates the application of the 
TCRGEN program to the SVDS file directory. For a general description of 
the input, refer to the run stream description provided in section E3.1.2. 

@RUN ... 

@USE DBF.,FML-L79351*SVDSTCL 

@XQT FML-L79361*PHPA. TCRGEN 

0FIN 

E5.4.4 SAMPLE OUTPUT FOR THE TCRGEN PROGRAM 

A portion of the printed output generated by the TCRGEN program execution 
follows. 
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TEST CASE 

ELEHENT 

USED BV 

TEST C 
TEST CASE ARO 

ASE USAGE n 
MOT tMCLUOED !M THE 

£ P 0 H T I 
RASTER FILE 

» ■* 

MG SYSTEn 
ELEWEMT DIRECTORY 

Q 

ftLTl 

CLOCK 

fiFHME 

FNARE 

FILEIO 

GETOAT 

nOVER 

nCONT 

PCTD 

STIME 

flLta 

CLOCK 

EFNAflE 

FNAnE 

FILEIO 

GETOAT 

nOVER 

IICOMT 

PCTO 

5TIME 

OECKl 

CLOCK 

EFAfAnE 

FNAmE 

FILEIO 

GETOAT 

nOVER 

IICONT 

PCTD 

5TIME 

DECKIO 

TRACER 

CLOCK 

EFIVARE 

FKlAnE 

FILEIO 

GETDAT 

nOVER 

IICONT 

PCTO 

STIME 

OECKIi 

CLOCK 

EFATAIIE 

FKlAnE 

FILEIO 

GETDAT 

nOVER 

IICONT 

PCTO 

STIME 

DECK 12 

TRACER 

CLOCK 

EFRAnE 

FNAnE 

FILEIO 

GETOAT 

nOVER 

IICONT 

PCTD 

STIME 

DECK 2 

CLOCK 

EFJJARE 

FNAnE 

FILEIO 

GETOAT 

flOVEfl 

IICONT 

PCTD 

STIPIE 

DECK 3 

CLOCK 

EFNftflE 

FNAPIE 

FILEIO 

GETDAT 

MOVER 

IICONT 

PCTO 

STIME 

DECK*! 

CLOCK 

EFf^fl(»]E 

FNAflE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTD 

STIME 

DECK? 

CLOCK 

EF^^AtlE 

FNAPIE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME- 

DECK6 

TRACER 

CLOCK 

EFNAWE 

FNAPJE 

FILEIO 

GETDAT 

MOVER 

IICONT 

PCTD 

STIME 

OECKT 

TRACER 

CLOCK 

EF^An£ 

FNAnE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

DECKS 

TRACER 

CLOCK 

EFNftPlE 

FNAHE 

FILEIO 

GETDAT 

MOVER 

IICONT 

PCTO 

STIME 

DECKS 

CLOCK 

EFfVAnE 

FNAWE 

FILEIO 

GETDAT 

MOVER 

IICONT 

PCTD 

STIME 

E«TRY1 

TRACER 

CLOCK 

EFNAPIE 

FNflflE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTD 

STIME 

EfliTfly3 

CLOCK 

EFflJAME 

FlLEfO 

FNARE 

GETOAT 

irCONT 

MOVER 

PCTO 

SNAVD 

ENTRVS 

STIRE 

CLOCK 

EFI^AHE 

FNAnE 

FILEIO 

GETDAT 

MOVER 

IICONT 

PCTO 









1 . 


. ...., 



Vf 




❖ 




REPKODUCIBILrrY OP THE 
ORIGINAL PAGE IS POOR 


nr 


TEST CASE USAGE AEPORTtNG SV5TEN 
TEST CASE ELEMENT USED BV TEST CASE AND NOT INCLUDED IN THE MASTER FILE ELEMENT OIRECTORV 


ENTAV5 

CLOCK 

EFNAME 


FILEIO 

GETQAT 

MOVER 

IICONT 

PCTO 

STIME 

6NC0RB 

CLOCK 

EFNAME 

FNAHE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

GNCl 

CLOCK 

EFNAME 

FNAflE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

G!VC2 

CLOCK 

EFNAME 

PHMZ 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

GNC3 

CLOCK 

EFNAME 

FNftflE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

GNC^ 

CLOCK 

EFNAME 

FMAflE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 


CLOCK 

EFNAME 

FfUAPtE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

LAUNCH5 

CLOCK 

EFNAME 

Fh|Af*iE 

FILEIO 

GETQAT 

MOVER 

IICONT 

PCTO 

STIME 

LRUniCH«i 

CLOCK 

EFNAME 

FNADE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

LAUNCH3 

CLOCK 

FILEIO 

6ET0AT 

HOVER 

I ICON! 

PCTO 

STIME 

TRACER 


Lt^UWHZ 

CLOCK 

:-FNAME 

FMAnE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

LAUNCHl 

CLOCK 

TRACER 

EFNAME 

FNAnE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

'STIME 

NRVGl 

CLOCK 

EFNAME 

FAlAnE 

FILEIO 

GETQAT 

MOVER 

IICONT 

PCTO 

STIME 

NRVE2 

CLOCK 

EFNAME 

FNAriE 

FILFIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

NAVLl 

CLOCK 

TRACER 

EFNAME 

FNAPIE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

Ql^St 

CLOCK 

TRACER 

EFNAME 

FIVA^E 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 

OR8ITI 

CLOCK 

EFNAME 

F«ftWE 

FILEIO 

GETOAT 

MOVER 

IICONT 

PCTO 

STIME 





TEST C 

A S E U 

SAGE R 

E P 0 n T I 

N 6 $ y S T E 

n 

TEST CUSE 

ELEMENT USED »Y 

TEST CASE AND 

NOT INCLUDED IN THE 

FASTER FILE 

ELEMENT DIRECTORY 

0HB1T2 

CLOCK 

tPHME 

PNAFIE 

FILEIO 

6ET0AT 

novER 

lICQNT 

PCTO 

flCSl 

CLOCK 

EFRlAnE 

FHAnE 

FtLEIQ 

GETOAT 

flOVER 

IICOr^T 

PCTD 

RC52 

CLOCK 

EFNAflE 

FMAHE 

FILETO 

GETDAT 

PIQVER 

IICONT 

PCTO 

SRSDKl 

CLOCK 

TRACER 

EFNAHE 

FNAHE 

FILEIO 

GETOAT 

nOVER 

IICORfT 

PCTO 

TBftPTC 

CLOCK 

PCTO 

EFMAnE 

STIWE 

FMAHE 

FILEIO 

GETOAT 

nOVER 

IICOMT 

NSTOPS 

filNDt 

CLOCK 

EFNfttlE 

FNANE 

FILEIO 

GETDAT 

nOVER 

IICONT 

PCTO 


STItlE 
STinE 
STinE 
ST WE 
NUEF» 
STIPIE 
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TEST CASE USAGE REPOBTING SYSTEfI 


( • IKOICATES RASTEfi ELE*^EWT OIRECTORV TIPtE AMD tJATE DO MOT COIMCIOE WITH THE ELEWEMT USED BY TEST CASE TIME AMO DATE) 






ALTl 

ALT2 

ELEMENT 

VERSION 

CREATION 

CREATION 

05/19/76 

05/11/76 

NAME 

NAME 

DATE 

TIME 

16:32:15 

IS :08:93 

AABTAH 


05/05/76 

12:38:96 



AAINtr 


09/07/76 

16:55:55 



AA5NSP 


03/02/76 

16:30:57 



ABINO 


Ot/09/76 

09:39:96 



ABINDI 


09/05/75 

18:22:52 



ABINDl 


01/09/76 

10:06:58 



ACCALC 


03/02/76 

16:30:58 



ACCGRP 


05/05/76 

12:39:06 



ACCUPO 


05/05/76 

12:39:96 



ACMAUP 


05/05/76 

12:92:35 



ACMEA5 


05/05/76 

12:93:35 



ACSINT 


11/05/75 

11:05:00 

X 

X 

AC5UP 


05/05/76 

12:99 :30 



ACSUP2 


05/05/76 

12:95:56 



ACS15 


05/05/76 

12:99:39 

X 

X 

ACTTVC 


09/07/76 

16:27:05 



AD SEN 


09/07/76 

16:27:16 



AOSET 


01/09/76 

09:35:29 

»X 

•X. 

A05QP 


09/07/76 

16:27:39 



AEPHEM 


01/09/76 

09:56:5 7 



AEBALT 


09/07/76 

16:27:58 

X 

X 

AERAUX 


05/05 /76 

12:51:19 



aero 


05/05/76 

12:51:55 



AGIN 


09 /07/76 

16:28:25 



AG SUP 


01/09/76 

09:37:39 



AGUID 


05/05/76 

12:53:10 



ALDEN5 


05/05/76 

12:55:29 



ALEC 


03/02/76 

16:31:51 



ALIGN 


03/02/76 

16:31:98 

X 

X 

ALOCVF 


09/07/76 

16:55:59 



ALPRD 


01/09/76 

09:36:07 



ALPRNT 


03/02/76 

16:31:59 



ALTBLR 


01/09/76 

09:93:50 

X 

X 

ALTDLL 


09/07/76 

16:28:92 

X 

X 

ALTIMR 


05/05/76 

12:55:36 



ANOM 


01/09/76 

09:39:12 

X 

X 

ANSUP 


01/09/76 

09:93:56 



ANSWER 


09/05/75 

18 ;27 



AOATAR 


05/05/76 

12:5. 



AQM5 


05/05/76 

12:55:59 



AOMSG 


05/12/76 

21:23:09 



AOnSIN 


09/07/76 

16:28:59 



ARCQ5 


09/05/75 

18:28:36 

X 

X 

ARnSPF 


01/09/76 

10:06:16 



ARELST 


05/05/76 

12:56:17 



AfilNTP 


09/07/76 

U :56;96 



ARMEAS 


01/09/76 

09:99:06 



AROBLK 


09/09/75 

18:09 :39 

X 

X 

AROCAL 


09/07/76 

16:29:03 

X 

X 

AROCON 


09/07/76 

16:29:12 


1 


OECKl OECKIO DECKll DECK12 DECK2 DECKS OECK^ 

05/U/76 05 /U/76 05/15/76 05/11/76 05/11/76 05/11/76 05/11/76 

07:*f6tl3 09:00:00 09j58t3'l 06:17*09 09:21:57 13:56:25 12:33:38 


*X 


X X X X X X X 

X X X X X X X 

X X 


X 

X X 

X X 

/■ ' 


w 
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% 


TEST CASE USAGE AEPORTIHG SYSTEM 

I • INOtCATES MASTER ELEWEKT OtRECTORV TIME AMO DATE 00 NOT COINCIDE WITH THE ELEMENT USED BV TEST CASE TIME AND DATE) 







ALTl 

ALT2 

OECKl 

DECK 10 

OECKll 

DECK 12 

DECK2 

0ECK3 

0ECK9 

ELEdEMT 

VERSION 

CAEATfON 

CREATION 

05/19/76 

05/U/76 

05/11/76 

05/11/76 

05/15/76 

05/11/76 

05/11/76 

05/11/76 

05/U/76 


^AHE 

OATE 

TIME 

16:32:15 

15:08:93 

07:96:13 

09:00:00 

09:58:39 

08:17:09 

09«21 ;57 

13:56:25 

12:33:38 

XESTAB 


05/05/76 

I3i31:28 










XLIHIT 


09/05/75 

09i53:35 

X 

X 








xoms 


05/19/76 

13:56:13 

X 


»X 

*X 

X 


*X 

«X 

»X 

SV2TQE 


09/05/75 

09:53:39 

X 

X 

X 
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w — 


TEST CASE USAGE REPORTING SVSTEP1 


{ • INDICATES MASTER ELEMENT QIRECTORV TIME AND DATE DO NOT COINCIDE WITH THE ELEMENT USED BT TEST CASE TIME AND DATES 


ELEMENT 

NAME 

AABTAR 

AAINIT 

AASNSP 

ABIND 

ABtNDT 

ABINDI 

ACCALC 

ACCGRP 

ACCUPO 

ACMAUP 

ACHEAS 

ACSTNT 

AC SUP 

AC5UP2 

ACS15 

ACTTVC 

ADSEN 

AOSET 

ADSDP 

AEPHEM 

AERALT 

AERAUX 

AERO 

AGIN 

AG SUP 

AGuro 

ALDENS 

ALFC 

ALIGN 

ALOCVF 

ALPRD 

ALPRNT 

ALTBLK 

ALTOLL 

ALTIMR 

ANON 

AN SUP 

ANSWER 

AOATAR 

AOMS 

AOMSG 

AOMSIN 

ARCD5 

ARDSPF 

AREL5T 

ARINTP 

ARMEAS 

AROBLPT 

AftOCAL 

AROCDA 


VERSION 

NAME 


CREATION 

DATE 

05/05/7S 

0^*/07/76 

03/02/76 

01/09/76 

09/05/75 

01/09/76 

03/02/76 

05/05/76 

05/05/76 

05/05/76 

05/05/76 

11/05/75 

05/05/76 

05/05/76 

05/05/76 

09/07/76 

09/07/76 

01/09/76 

09/07/76 

01/09/76 

09/07/76 

05/05/76 

05/05/76 

09/07/76 

01/09/76 

05/05/76 

05/05/76 

03/02/76 

03/02/76 

09/07/76 

01/09/76 

03/02/76 

01/09/75 

09/07/76 

05/05/76 

01/09/76 

01/09/76 

09/05/75 

05/05/76 

05/05/76 

05/12/76 

09/07/76 

09/05/75 

01/09/76 

05/05/76 

09/07/76 

01/09/T6 

09/09/75 

09/07/76 

09/07/76 


CREATIO 
TIME 
12:38:9 
16:55:5 
I6;30:5 
09:39 :9 
18:22:5 
10:06:5 
16:30:5 
l2:39tC 
12:39:9 
12 : 92 :^ 
12:93; ■ 
11:05 ;C 
12:99 
12:95 ;5 
12:99:: 
16:27:C 
i6:27;1 
09:35 :2 
6 : 27 :: 
09:56:5 
16:27:5 
12:51 : I 
12:51:5 
16 : 28 ;: 
09 : 37 :: 
12:53:1 
12:55:2 
16:31:5 

16:55:5 

09:38:( 

16:31:5 

09:93:5 

16:28:f 

12:55 

09:39 ;] 

09:93:5 

18:27:5 

12:55 

12:55:5 

21:23:< 

16:28:5 

la ;28:: 

10:06:1 

12:56:1 

16 :56:< 

09 :99 :( 

18:09 

16 :29;( 

16:29:; 


DECKS DECK6 DECK? OECK0 DECK9 ENTRY! ENTRV3 ENTRY9 ENTRY5 

05/11/76 05/11/76 05/11/76 05/11/76 05/11/76 05/11/76 05/20/76 05/13/76 05/11/76 

09:92:00 09:16:39 50:17:03 07:35:23 10:27:52 23:50:39 19:57:39 22:06:51 20:13:95 



X 


X 










TEST CJISB 


U $ « 


0^^ 


REEonrtwG 


s V s r E M 



C • tMOICATES HASTED EUEHEHT OIRECTORV TIHE MO DATE 00 NOT COtNCIOE UITH THE ELEnENT USED 8V TEST CASE TtHE AND DATE) 






DECK5 

0ECK6 

DECK? 

DECKS 

QECK9 

ENTRVI 

ENTRV3 

EMTRV9 

E^TRVS 

ELCnEfiT 

VERSION 

CHEATJOW 

CREATtQN 

05/11/76 

05/11/76 

05/11/76 

05/U/T6 

05/11/76 

05/11/76 

05/20/T6 

05/13/76 

05/11/76 

ftMZ 

XESTAS 

XLIMfT 

NANE 

DATE 

05/05/76 

05/05/75 

TWE 

13:31:28 
09:5 3:35 

09:92:00 

09:16:39 

10:17:03 

0T:35;23 

10:27:52 

23:50:39 

I‘*:57i3‘l 

22:06 :57 

20:13:95 

XOTQPS 

XV2T0E 


05/I5/T6 

09/05/75 

13=56:13 

09:53:39 

vX 


vX 

*X 

•X 

«X 

X 

♦X 

• X 


if 

I 

!? 

fi 

ii 

I 

!{ 
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TEST CASE USAGE REPOnTING SYSTEtl 


III 


< • ffiOICilTES «STER ELEMENT OtBECTORV TIME AND DATE DO NOT COINCIDE UITK THE ELEMENT USED BY TEST CASE T1^1E AND DATE) 


ELEMENT 

NAME 

AABTAR 

AAINET 

AA5NSP 

ABINO 

ABINDI 

ABINDl 

ACCALC 

ACCSRP 

ACCUPO 

ACMAUP 

ACMEAS 

ACSINT 

AC SUP 

ACSUP2 

ACS15 

ACTTVC 

AD SEN 

ABSET 

AOSQP 

AEPHEM 

AERALT 

AERAUX 

AERO 

AS IN 

AS SUP 

AGUIO 

ALOENS 

ALFC 

ALIGN 

ALOCVF 

ALPRD 

ALPRWT 

ALTSLA 

At TOLL 

ALTIMR 

ANON 

ANSUP 

ANSWER 

AOATAR 

AOMS 

Aonss 

AQM5IN 

ARCQS 

ARBSPP 

ARELST 

ARINTP 

ARMEAS 

AROBLA 

A'^OCAL 

I 


VERSION 

NAME 


CREATION CREATION 
BATE TIME 

07/05/76 12:38:46 
04/07/7S 16:55:55 
03/02/76 16:30:57 
01/09/76 09:34:46 
09/05/75 18:22:52 
01/09/76 10:06:58 
03/02/76 16:30:58 
05/05/76 12:39:06 
05/05/76 12:39:46 
05/05/76 12:42:35 
05/05/76 12:43:35 
11/05/75 11:05:00 
05/05/76 12:44:30 
05/05/76 12:45 :56 
05/05/76 12:49:34 
04/07/76 16:27:05 
04/07/76 16:27:16 
01/09/76 09:35:24 
04/07/76 16:27:34 
01/09/76 09:56:57 
04/07/76 !6:27:5S 
05/05/76 12:51:19 
05/05/76 12:51:55 
04/07/76 16:28:25 
01/09/76 09:37:34 
05/05/76 12:53:10 
05/05/76 12:55:24 
03/02/76 16:31:51 
03/02/76 16:31:48 
04/07/76 16:55:59 
01/09/76 09:38:07 
03/02/76 16:31:54 
01/09/76 09:43:50 
04/07/76 16:28:42 
05/05/76 12:55:36 
01/09/76 09:34:12 
01/09/76 09:43:56 
09/05/75 10:27:52 
05/05/76 12:55:48 
05/05/76 12:55:54 
05/12/76 21:23:09 
D4/0T/76 16:28:54 
09/05/75 18:28:36 
01/09/76 10:06:16 
05/05/76 12:56:17 
04/07/76 16:56:46 
01/09/76 09:44:06 
09/09/75 10:04:39 
04/07/76 16:29:03 
04/07/76 16:29:12 


GNCORB SNCl SNC2 GNC3 6NC4 BNC5 LAUIUCH5 LAUNCH4 LAUNCH3 

05/14/76 05/15/76 05/11/76 05/11/76 05/11/76 05/14/76 05/14/76 05/12/76 05/20/76 

15:46:34 18:02:53 06:03:36 08:44:39 14:36:44 00:43:58 00:57:31 13:07:07 02:12:12 

X 

X 


•X #X *X 


♦ X 


9 X »X *X 


X 

X 

X 


X X X 


XXX 
X X 

X 


X 

#x 

X 


XXX 

XXX 

XXX 

XXX 

X 

XXX 

X X 

XXX 

X 

X X 

*X X 

X X 


XXX 

XXX 

X 


i- 


X 

X 


X 

X 


X 

X 


X 

X 


X 

X 



« I 




t 




' TCSTCI»SEUSHGE^rtEP0ftTI«6SVSTE« 

f « INDICATES nASTED ELEHENT OIAECTORV TINE AND DATE DO NOT COINCIDE UITH THE ELENENT USED BY TEST CASE TIHE AND DATE) 


6NC0RB GNCl GNC2 5NC3 GNC4 GNC5 LAUNCH5 LAUNCKA LAUNCH3 

VERSICN CREATIDN CREATION 05/l*»/T6 05/15/76 05/11/76 05/11/76 05/11/76 OSttH/Ji 05/1*1/76 05/12/76 05/20/76 

NRriG DATE TINE 15tN6:3>l 18:02:53 08:03:36 08:4<l;39 t‘l;3&:4‘l 00:43:58 00:57:31 13:07:07 02:12:12 

05/05/T6 13:31:28 
09/05/75 09:53:35 

05/19/76 13:56:13 X X »X »X *t *X *X X 

09/05/75 09:53:39 XX XXX 
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TEST CASE USAGE AEPORTfAIG SVSTEPt 
I • INDICATES WASTER ELEWENT DIRECTODV TIME AND DATE 00 NOT COINCIDE WITH THE EtEWENT USED fiV TEST CASE TlWE AND DATE) 






LAUNCR2 

LAUNCHl 

NAVE! 

NAVE2 

NAVLl 

owsi 

ORfllT! 

0RBIT2 

ELEftENT 

VERSION 

CREATION 

CREATION 

05/11/76 

05/11/76 

05/17/76 

05/12/76 

05/11/76 

05/15/76 

05/11/76 

05/12/76 

NAME 

NAME 

DATE 

TINE 

08:06:33 

09:16:13 

19:26:99 

15:59:01 

08:58:13 

10:93:28 

13:18:21 

16:00:28 

AASTAR 


05/0S/76 

12:38 s96 









AAINIT 


OA/07/76 

16:55 ;55 









AASNSP 


03/02/76 

16:30 :57 



X 

X 





AD INO 


01/09/76 

09:39:96 









A8INDI 


09/05 /75 

18:22:52 









ADINDI 


01/09/T6 

10:06:58 









ACCALC 


03/02/76 

16:30:58 






X 



ACCGRP 


05/05/76 

12:39:06 






X 



ACCOPO 


05/05/75 

12:39:96 









ACnAUP 


05/05/76 

12:92:35 









ACnEAS 


05/05/76 

12:93:35 



X 

X 





ACSINT 


n/05/75 

11:05:00 









AC SUP 


05/05/76 

12:99 :30 









ACSUP2 


05/05/76 

12:95:56 









ACSIS 


05/05 /76 

12:99:39 









ACTTVC 


09/07/76 

16:27:05 









ADSEN 


09/07/76 

16:27:16 



X 

X 





AD5ET 


01/09/76 

09:35:29 


♦ X 

X 

X 

♦X 

♦ X 

♦X 

•X 

ADSOP 


09/07/76 

16:27:39 




X 

- 




AEPHEW 


01/09/76 

09:56:57 









AERALT 


09/07/76 

16:27:58 









AERAUX 


05/05/76 

12:51:19 









AERO 


05/05/76 

12:52:55 









AGIN 


09/07/76 

16:28:25 









AG SUP 


01/09/76 

09:37:39 









AGUID 


05/05/76 

12:53:10 









AL0EN5 


05/05/76 

12:55:29 









ALFC 


03/02/76 

16:31 :51 









ALIGN 


03/02/76 

16:31:96 

X 

X 

X 

X 

X 

X 

X 

X 

ALOCVF 


09/07/76 

16:55:59 









ALPRO 


01/09/76 

09:30:07 




X 





ALPRNT 


03/02/76 

16:31:59 









ALTBLK 


01/09/76 

09:93:50 









ALTDLL 


09/07/76 

16:28:92 

X 

X 

X 

X 

X 

X 

X 

X 

ALTIflR 


05/05/76 

12:55:36 




X 





ANOW 


01/09/76 

09:39:12 






X 

X 

X 

ANSUP 


01/09/76 

09:93:56 









ANSWER 


09/05/75 

18:27:52 









A0A7AR 


05/05/76 

12:55 :90 









AOHS 


05/05/76 

12:55:59 









AOnSG 


05/12/76 

21:23:09 









AOnSIN 


09/07/76 

16:28:59 









ARCQ5 


09/05/75 

16;2e:3& 







K 

X 

AROSPF 


01/09/76 

10:06:16 









AREL5T 


05 /05/76 

12:56:17 






• 



ARINTP 


09/07/76 

16:56:96 









ARnEAS 


01/09/76 

09:99:06 









ARaSLR 


09/09/75 

18:09:39 


X 





X 

X 

A R GCAL 


09/07/76 

16:29:03 


X 

X 

X 

X 




AROCOn 

r 

f 1 

09/07/76 

16:29:!2 


i 





r 

\ 


ACSl 


15 ; 06?28 


R 

n 




W I 







E-43 








TESTCASSUSAGE flEPOATlMG SYSTEH 

« • INDICATES nASTED ELEMENT OIRECTODV TIME AND DATE 00 NOT COINCIDE WITH THE ELEMENT USED BV TEST CASE TIME AND DATE I 


VERSION 

NAME 


CREATION 
DATE 
05/05 /76 
0^/07/T6 
03/02/76 
01/09/76 
09/05/75 
01/09/76 
03/02/76 
05/05/76 
05/05/76 
05/05 /76 
05/05/76 
il/05/75 
05/05/76 
05/05/76 
05/05/76 
09/07/76 
09/07/76 
01/09/76 
09/07/76 
01/09/76 
09/07/76 
05/05/76 
05/05/76 
09/07/76 
01/09/76 
05/05/76 
05/05/76 
03/C2/76 
03/02/76 
09/07/76 
01/09/76 
03/02/76 
01/09/76 
09/07/76 
05/05/76 
01/09/76 
01/09/76 
09/05/75 
05/05/76 
05/05/76 
05/12/76 
09 /07/T6 
09/05/75 
01/09/76 
J5/05/76 
09/07/76 
01/09/76 
09/09/75 
09/07/76 
09/07/76 


CREATION 

TIME 

12:30:96 
16:55:55 
16:30:5T 
09:39:96 
18:22:52 
10:06:58 
16:30:58 
12:39:06 
12:39:96 
12:92:35 
12:93:35 
11:05:00 
12:99:30 
12:95:56 
12:99:39 
16:27:05 
16:27:16 
09:35:29 
16:27:39 
09:56:57 
15:27:53 
12:51:19 
12:51-55 
16 : 28 : 2 ; 
09:37:39 
12:53:10 
12:55:29 
16:31:51 
16:31:98 
16:55:59 
09:38:07 
16:31:59 
09:93:50 
16:28:92 
12:55:36 
09:39:12 
09:93:56 
18:27:52 
12:55:90 
12:55 :59 
21:23:09 
16:28:59 
18:28:36 
10:06:16 
12:56:17 
16:56:96 
09:99:06 
18:09:39 
16:29:03 
16:29:12 


RCS2 SRBDKl TBAPTC WlNOl 
05/11/76 05/11/76 05/11/76 05/17/76 
19:37:91 10:22:32 11:32:90 16:57:39 


L ^ 
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TEST CftSE US<li5E^fiEP0flTI«8 SVSTEff 




i * MDICATES HftSTER ELEMENT DIRECTORY TIME MD DftTE DO NOT COINCIDE WITH THE ELEMENT USED BY TEST CRSE TIME RNO DATE I 


‘ 

■I 






RC52 

SHBDKl 

TBAPTC 

UlMDl j 

ELEMENT 

VERSION 

CREATION 

CREATION 

05/11/76 

C5/ 11/76 

05/11/76 

05/17/76 i 

NAME 

XESTRB 

SLIMIT 

NAME 

'ORTE 

05/05/76 

09/05/75 

TIME 

S3;S1:28 

09:53:35 

19:37:9! 

10:22:32 

tl:3£:90 

16;5T:3S i] 

[i 

XDTors 

XYZTOE 


05/19/76 

09/05/75 

13:56:13 

09:53:39 


»X 


* ii 

!i 
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TEST CASE KAn.ES U$I»S EACH ELEHE^T 


AABTAR 

SNC? 




AAINIT 

ENC5 




AASNSP 

NAVEl 

KAVE2 



A8IND 





A8IHDI 





ABINDl 





ACCALC 

0M51 

RCSl 


- 

ACCGRP 

0M51 

RC31 



ACCUPD 

GNCORB 




ACHADP 

ENC2 

GNC3 

GfUCA 

ENC? 

ACME AS 

NAVEl 

NAVE2 



ACSINT 

ALTl 

ALT2 

EWTRVl 

ENTRY9 

ACStiP 





AC5UP2 





AC5I? 

ALTl 

ALY2 

EMTRVl 

ENTRY9 

ACTTVC 





AD SEN 

ENTHV^ 

ENTBV5 

NAVEl 

NAVE2 

ADSET 

ALTl 
DECK 9 
LAUNCH3 
UINDI 

ALT2 OECKl 

ENTRYl ENTRV3 
LADIVCH2 LADNCHl 

DECKtO 

EHTRY9 

NAVEl 

ABSDP 

ENTRT9 

EWTBY5 

NAVE2 


AEFHEfl 





AERALT 

ALTl 

HLT2 



AERAU3C 

ENTBYl 

ENTRV'I 

RCS2 


AEHQ 

EfllTRVl 

eNTRYB 

RCS2 


Asm 

GNC2 

6NC3 

6NC4 

S«C5 


RCSE 


RCS2 


DECK 11 SgCK12 
E»VTRY5 ENCORB 
HAVE2 niAVLl 


DECK2 

DECKS 

DECK4 

DECKS 

DECK6 

5NC1 

BMC2 

SnC3 

ENC^ 

ENC5 

0M51 

orbiti 

0RBIT2 

RCSl 

RC52 


OP TBK 

oBimmi PA0B ts Poop 


0ECK7 DECKS 
LAUNCH? LAUNCH^ 
5RBDK1 TDAPTC 






r> 
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♦ ' I' 



ELEHEWT 



T E 

S T C 

A 5 E N 

A n E S 

V S I 

N G E A 

CHE 

L E PI E W T 


UR! TEX 












XORTE 

OECKl 

NAVE2 

ORBITl 









XESTAB 

ORBKTl 

0HBIT2 










1 XLiniT 

ALT! 

ALT2 

ONSl 

0RBIT2 








■i XOTOPS 

i 

ALTl 

OECK9 

LAUnjCft2 

ALT2 

ENTRY! 

LAUNCH! 

DECK! 

ENTRV3 

NAVE! 

DECKIO 

ENTRY** 

NAVE2 

DECK 11 
ENTRY5 
AIAVLI 

DECK 12 
61UC0RB 

onsi 

DECK 2 

GUCI 

ORBITl 

DECK 3 

GNC2 

0RBIT2 

OECK'f 

BUC3 

RCSl 

BECKS DECKS 

SNC4 GNC5 

RCS2 SRBBKI 

OECK7 DECKS 
LAUNCHS LAUNCH3 
TBAPTC UINDI 

XVZTOE 

ALTt 

ALT2 

DECK! 

DECKI2 

S^S-URB 

&IUCI 

GNCA 

GNC9 

LAUA1CH5 

oust BRBITl 

0RBIT2 


j 

i 







